步骤
一、环境准备(node，git)
# 查看版本
node -v
npm -v
git --version
二、hexo搭建
npm install -g hexo-cli
hexo init my-blog
cd my-blog
npm install
hexo clean && hexo g && hexo s
三、hexo主题切换
在 Hexo 博客根目录执行以下命令
git clone https://github.com/yelog/hexo-theme-3-hexo.git themes/3-hexo
代码高亮设置
# 关闭Hexo自带高亮，hexo下的_config.yml(7+版本)
syntax_highlighter: # empty
# ...
theme: 3-hexo # 启用主题
# 3-hexo下的_config.yml
highlight:
on: true # true开启代码高亮，开启需要关闭博客 _config.yml 中的 highlight
lineNum: false # true显示行号
copy: true # 复制功能
theme: Darcula
四、配置GitHub仓库
1.创建GitHub仓库
- 登录 GitHub，点击 New Repository
- 仓库名格式：<用户名>.github.io（如 yourname.github.io）（重点）
2.关联本地项目(在 Hexo 项目根目录执行)
git remote add origin https://github.com/yourname/yourname.github.io.git
五、配置Hexo部署插件
1.安装 hexo-deployer-git
npm install hexo-deployer-git --save
2.修改 Hexo 配置
打开 _config.yml，找到 deploy 字段并修改：
deploy:
type: git
repo: https://github.com/yourname/yourname.github.io.git
branch: main # 代码分支
message: "Update: {{ now('YYYY-MM-DD HH:mm:ss') }}"
六、生成静态文件并部署
hexo clean && hexo generate # 简写 hexo g
hexo deploy # 简写 hexo d
七、访问
- 打开 https://yourname.github.io
- 首次部署需等待 1-2 分钟
八、hexo相关命令
hexo clean # 清除生成的文件
hexo g # 生成静态文件
hexo s # 启动本地开发服务器，在本地浏览器预览博客
hexo d # 将博客发布到远程平台
九、注意事项
- github仓库 -> setting -> General -> Default branch(修改)
- github仓库 -> setting -> Pages -> Branch(修改) 重点
- github仓库 -> Actions：可查看部署是否成功
- 仓库名必须为：
<username>.github.io 或 <orgname>.github.io。 - 多博客实现方式（主站 + 项目站点（子路径））
- 主站仓库：username.github.io，存放主博客或导航页。
- 项目仓库：创建 blog-1、blog-2 等仓库，部署到 gh-pages 分支。
- 访问地址：主站：https://username.github.io，子博客：https://username.github.io/blog-1
# 在子博客的 _config.yml 中设置 root 参数 url: https://username.github.io/blog-1 root: /blog-1/ - config.yml中的分支及repo需要与github配置的保持一致
