一、环境准备

1. Node.js 安装

  • 前往Node.js官网下载对应系统（Windows/macOS/Linux）的稳定版安装包；
  • 双击安装包，全程选择默认选项完成安装；
  • 验证安装结果：打开系统命令提示符（CMD/终端），执行以下命令：
1
2
## 检查 Node.js 版本（返回版本信息即成功）
node -v

进行npm换源，运行：

1
npm config set registry https://registry.npmmirror.com

无报错提示即代表换源完成。

2. Git 安装

  • 前往Git官网下载对应系统版本；
  • 安装时保持默认选项；
  • 验证安装结果：
1
2
# 检查 Git 版本（返回 git version x.x.x 即成功）
git --version

3. 安装Hexo

打开安装好的Git Bash，执行安装命令：

1
npm install -g hexo-cli

进行安装，然后运行：

1
2
# 检查Hexo版本（返回版本信息即成功）
hexo -v

4. GitHub 仓库准备

  • 需先注册GitHub账号，创建用于托管博客的仓库；
  • 登录GitHub创建仓库；
  • 仓库名必须严格遵循格式：<GitHub用户名>.github.io（例如zyh111.github.io）；
  • 建议将仓库设置为「Private」（私密）；
  • 运行：
1
2
git config --global user.name "你的 GitHub 用户名"
git config --global user.email "你的 GitHub 注册邮箱"

-验证配置结果：

1
git config -l
  • 输出结果中能看到配置的 name 和 email 即成功

5. 连接至GitHub

  • 运行：
1
ssh-keygen -t rsa -C "你的邮箱"
  • 直接按几次回车生成ssh密钥，用于此电脑连接至GitHub
  • 之后打开C盘用户文件夹下的.ssh的文件夹，用记事本打开 id_rsa.pub，复制里面的内容
  • 登录 GitHub → 点击右上角头像 →「Settings」→「SSH and GPG keys」→「New SSH key」；
1
2
Title：自定义
Key：粘贴复制的公钥内容
  • 点击「Add SSH key」完成添加
  • 测试 SSH 连接，运行：
1
ssh -T git@github.com
  • 出现连接到账户即代表连接成功。

二、新建Hexo博客项目

新建Hexo博客项目

  • 选择本地存放博客的文件夹（如桌面），右键点击「Open Git Bash here」；
  • 运行：
1
2
3
4
# 替换 <项目名> 为自定义名称（如my-blog）
hexo init <项目名>
# 进入项目
cd <项目名>

安装项目依赖包

  • 运行：
1
npm install

三、本地预览 Hexo 博客

  • 参考官方配置文档
  • 推荐使用Visual Studio Code打开博客项目文件夹
  • 打开 VS Code 终端（顶部菜单「终端」→「新建终端」），执行命令：
1
hexo cl; hexo g; hexo s
  • 打开浏览器，访问localhost:4000/，能看到 Hexo 默认博客页面即代表本地运行成功；
  • 按「Ctrl + C」可终止本地服务

四、安装博客主题

五、部署到GitHub

安装hexo-deployer-git：

1
npm install hexo-deployer-git --save

配置部署信息：

  • 编辑项目根目录的 _config.yml 文件，找到 deploy 部分，修改为：
1
2
3
4
deploy:
    type: git
    repository: git@github.com:<你的用户名>/<你的用户名>.github.io.git
    branch: main

保存配置后，执行部署命令：

1
hexo cl; hexo g; hexo d;

验证部署结果：

终端输出「Deploy done」即代表部署成功；

六、部署到 Vercel

登录Vercel：

  • 访问 Vercel官网，使用 GitHub 账号授权登录；
  • 导入 GitHub 仓库；
  • 点击「Add New」→「Project」；
  • 找到 <你的用户名>.github.io 仓库，点击「Import」；
  • 无需修改任何配置，直接点击 「Deploy」，等待部署完成；

配置自定义域名：

  • 部署完成后，进入项目页面 →「Domains」；
  • 点击「Add Domain」，输入你的自定义域名（如 blog.yourname.com）；
  • 前往域名服务商的域名管理页面，添加 Vercel 提供的 DNS 解析记录；
  • 等待解析生效后，即可通过自定义域名访问博客