前言

环境搭建

Hexo基于Node.js运行，在搭建过程中还需要使用Git，若没有下载安装即可。

链接：
Node.js | Git

连接Git与Github

在任意文件夹下右键 -> Git Bash Here, 设置Github用户名及主邮箱

1
2
git config --global user.name "Github用户名"
git config --global user.email "Github主邮箱"

创建SSH密钥：

输入 ssh-keygen -t rsa -C "Github邮箱" 并一路回车。

添加密钥：

  • 在用户目录的找到 .shh 目录，复制公钥 id_rsa.pub 里的内容。
  • 登录Github并进入 Settings，点击左侧 SSH and GPG keys, 点击 New SSH key。
  • Title 可以自由发挥，但建议标上设备名称，将 id_rsa.pub 的内容粘贴到Key中后，点击 Add SSH key。

验证连接：

在Git Bash中输入 ssh -T git@github.com ,出现 “Are you sure…” 后输入 yes 确认。

注：若连接失败，请检查：是否启用系统代理，22 端口是否开放。

创建Github仓库

点击Github主页右上角加号->New repository

  • Repository name填写用户名.github.io
  • 选填 Description，自由选择 README 文件
  • 点击 Create repository 创建仓库

搭建过程

安装Hexo

创建一个空文件夹用于存放 Hexo 文件，进入文件夹后：右键 -> Git Bash Here

1
2
3
4
5
6
npm install -g hexo-cli # 安装Hexo
# 安装成功后继续：
hexo init # hexo初始化
npm install # 安装组件
hexo g # 生成静态页面
hexo s # 启动本地服务器

浏览器访问http://localhost:4000, 出现 Hexo 默认页面则安装完成。

注：若页面未加载且此前从未报错，尝试更改端口号hexo server -p 5000后重试。

部署到Github Pages

本地测试成功后就可以在 Github 部署：

  • 安装 hexo-deployer-git: npm install hexo-deployer-git --save
  • 修改博客根目录 _config.yml文件末尾 Deployment 部分如下：
1
2
3
4
deploy:
  type: git
  repository: git@github.com:用户名/用户名.github.io.git
  branch: main
  • 运行 hexo d 将页面部署到Github Pages

此时访问 https://用户名.github.io 就可以看到我们的网站了。