用 Git 搭建博客

Posted on Edited on

用 Git 搭建个人博客最流行、最省心的方案是：

“本地 Hexo + GitHub Pages（或 Cloudflare Pages）”——完全免费、无需买服务器、还能绑定自定义域名。下面给出 2025 年验证可行的完整流程，按顺序照做即可上线。

一、准备工作

注册 GitHub 账号, 安装 Node.js（≥18）和 Git，终端执行确认版本：

1
2
node -v
git --version

二、本地初始化博客

全局安装 Hexo 脚手架

1
npm install -g hexo-cli

新建并进入博客目录

1
2
hexo init myblog && cd myblog
npm install

本地预览

1
hexo server          # 浏览器访问 http://localhost:4000 能看到默认页面

三、创建远程仓库

GitHub 新建公开仓库，命名必须为：

<你的GitHub用户名>.github.io

记录仓库的 SSH 地址（后续部署用）。

四、一键部署配置（最简版）

安装 Git 部署插件

1
npm install hexo-deployer-git --save

编辑博客根目录 _config.yml，末尾追加：

1
2
3
4
deploy:
type: git
repo: git@github.com:<用户名>/<用户名>.github.io.git
branch: main          # 与仓库默认分支保持一致

生成并首次上传

1
hexo clean && hexo generate && hexo deploy

看到 “Deploy done” 即成功。

浏览器访问 https://<用户名>.github.io 即可看到博客。

五、写作与发布

新建文章

1
hexo new post "我的第一篇文章"

会在 source/_posts/ 生成同名 .md 文件。

用 Markdown 写完保存，执行

1
hexo clean && hexo generate && hexo deploy

代码提交后 30 秒左右线上自动更新。