Hexo + GitHub Pages：个人博客搭建实践

发表于 更新于 分类于 本文字数： 619 阅读时长 ≈ 2 分钟
1\\\\\\\\. 环境准备 Hexo 基于 Node.js，搭建过程需要以下工具： 必备软件安装 | 软件名称 | 下载地址 | 验证安装命令 | | | | | |...

1. 环境准备

Hexo 基于 Node.js，搭建过程需要以下工具：

必备软件安装

软件名称 下载地址 验证安装命令
Node.js 官网下载 node -v
Git 官网下载 git --version

安装完成后，按 Win+R 输入 cmd 打开命令行，依次执行验证命令，出现版本号即表示安装成功。

2. GitHub 配置

2.1 账户注册

  1. 访问 GitHub官网
  2. 选择免费账户（Free）
  3. 完成邮箱验证

2.2 SSH 密钥配置

1
2
3
4
5
6
# 设置全局用户名和邮箱
git config --global user.name "GitHub用户名"
git config --global user.email "GitHub邮箱"

# 生成SSH密钥
ssh-keygen -t rsa -C "GitHub邮箱"  # 连续回车即可

添加密钥到GitHub：

  1. 访问 C:\Users\用户名\.ssh（需显示隐藏项目）
  2. 用记事本打开 id_rsa.pub 并复制内容
  3. GitHub → Settings → SSH and GPG keys → New SSH key
  4. 粘贴密钥内容并保存

验证连接：

1
ssh -T git@github.com  # 输入yes确认

3. 创建GitHub Pages仓库

  1. GitHub主页点击 New repository
  2. 仓库名格式：用户名.github.io
  3. 勾选 Initialize with a README
  4. 创建后自动启用HTTPS，访问地址：https://用户名.github.io

4. Hexo博客安装

4.1 安装Hexo

1
npm install -g hexo-cli

Mac用户需要加sudo权限：

1
sudo npm install -g hexo-cli

4.2 初始化博客

  1. 新建文件夹（如 Hexo-Blog）
  2. 右键选择 Git Bash Here
  3. 执行以下命令：
1
2
hexo init      # 初始化
npm install    # 安装组件

4.3 本地预览

1
2
hexo g   # 生成静态文件
hexo s   # 启动本地服务器

访问 http://localhost:4000 查看效果

5. 部署到GitHub Pages

5.1 安装部署插件

1
npm install hexo-deployer-git --save

5.2 修改配置文件

编辑 _config.yml 文件末尾：

1
2
3
4
deploy:
  type: git
  repository: git@github.com:用户名/用户名.github.io.git
  branch: master

5.3 部署博客

1
hexo d  # 部署到GitHub

访问 https://用户名.github.io 查看线上博客

6. 常用命令速查表

命令 功能
hexo new "文章名" 新建文章
hexo new page "页面名" 新建页面
hexo g 生成静态文件
hexo s 本地预览
hexo d 部署到GitHub
hexo g -d 生成并部署
hexo clean 清除缓存
hexo help 查看帮助

7. 进阶建议

  1. 更换主题：修改 _config.yml 中的 theme 配置项
  2. 自定义域名：在仓库设置中添加CNAME文件
  3. 开启Travis CI实现自动部署
  4. 使用GitHub Actions自动化构建流程

提示：每次修改内容后，建议按顺序执行 hexo clean && hexo g && hexo d 确保更新生效