什么是 Hexo？

Hexo 是一个快速、简洁、高效的静态博客框架，适合喜欢 Markdown 的人。

安装步骤（基于M4 Mac mini）

1. 下载Node.js并安装

https://nodejs.org/zh-cn/download

2. 初始化git

1
2
3
4
5
6
7
8
9
10
# 设置全局 Git 用户名和邮箱
git config --global user.name "github账户名称"
git config --global user.email "github账户邮箱"

# 生成 SSH 密钥
ssh-keygen -t rsa -C "github账户邮箱"

# 显示 SSH 公钥
cat /Users/tianlejin/.ssh/id_rsa.pub
# 进入 Settings 页面，选择左边栏的 SSH and GPG keys，点击 New SSH key，将以上输出复制到github网页端的SSH key

3. 安装hexo

1
2
# sudo npm install -g [email protected]
sudo npm install -g hexo-cli
  • 20250729补充：
1
2
3
4
5
6
7
8
# ubantu安装
sudo apt install nodejs npm           # 安装 Node.js 和 npm
sudo npm install -g n                 # 安装 Node.js 版本管理工具 n
sudo n lts                            # 安装最新 LTS 版本的 Node.js
hash -r                               # 刷新终端命令缓存
node -v                               # 查看 Node.js 版本
sudo npm install -g hexo-cli          # 全局安装 Hexo 命令行工具
hexo -v                               # 查看 Hexo 版本

4. 初始化hexo

1
2
3
4
5
6
7
8
9
10
11
12
13
# 初始化一个新的 Hexo 博客项目
hexo init

# 安装 Hexo 项目所需的依赖包（根据 package.json）
npm install

# 把 Markdown 文章渲染成 HTML 页面
hexo generate
# 或hexo g

# 启动本地预览
hexo server
# 或hexo s

在 http://localhost:4000 即可预览生成网页

5. 部署到 GitHub Pages

1
2
# 安装 hexo-deployer-git
npm install hexo-deployer-git --save

修改 _config.yml 文件末尾的 Deployment 部分：

1
2
3
4
deploy:
  type: git
  repository: [email protected]:用户名/用户名.github.io.git
  branch: main
1
2
3
# 将生成的静态网站（public 目录）部署到远程仓库（如 GitHub Pages）
hexo deploy
# 或hexo d

大功告成！最后访问我们的 GitHub 域名 https://用户名.github.io 就可以看到 Hexo 网站了！

参考

https://zhuanlan.zhihu.com/p/60578464