本文章是基于Windows11平台进行本地搭建和部署
1.准备Hexo环境
1.1 准备NodeJS环境
打开 https://nodejs.org/en 下载NodeJS并按照安装提示配置环境变量
安装完成后，打开Shell/PowerShell输入命令node --version查看是否安装成功
1.2 安装hexo
打开Shell/PowerShell，输入 npm install -g hexo-cli 开始安装hexo脚手架
创建要保存博客的文件夹，并打开目录
hexo init 你的目录名
cd 你的目录名
npm install
至此，初始化完成，可以通过输入命令 hexo g 和 hexo s来生成渲染并创建本地Server，成功后在localhost:4000既可以查看初始效果
2.配置
2.1 基础配置
hexo初始化完成时，会生成一个*_config.yml*文件，该文件即是全局配置文件
可以修改一些常用的配置，来进一步美化博客样式
- title 表示打开网站时，浏览器标题卡显示的内容
- url 后续部署时使用的域名
- author 作者
2.2 主题配置
配置文件中存在一个theme属性，通过配置该属性可以调整主题
hexo支持的所有主题都可以在官网中查看 https://hexo.io/themes/
选择合适的主题比如pure/fabric等，需要经过以下几步骤
- 寻找其theme下载地址，一般都在github上存在，将其git clone url themes/name 目录中
- 将_config.yml中的theme属性替换为下载的属性名即可
- 其他细节配置方式可以查看对应主题的设置文档，整体流程都是一致的
2.3 使用hexo-themes-pure时的注意事项
由于配置了tags/categories属性，所以需要把themes/pure/_source目录中对应的tags/categories目录与根目录的source目录合并，这样才不会出现CANNOT GET /tags或者CANNOT GET /categories 错误
3.开始创作
3.1 创建文章
由于默认创建的都是md文件，这里不再赘述语法问题
通过执行 hexo new page name创建一片新的文章，同时目录中会生成多个文件
- 同名的目录，用于存放资源
- 同名的md文件，用于编写博客内容
3.2 本地预览
如果使用VSCode编写，可以先用md查看查看预览效果
如果想查看网页中的效果，可以先本地部署查看
hexo clean
hexo g
hexo s
open localhost:4000查看渲染效果
4.远端部署
4.1 开启GitHub-Pages功能
具体操作详见GitHub提供的操作指南
https://pages.github.com/
4.2 一键部署
通过命令安装插件 npm install hexo-deployer-git --save
打开 _config.yml 文件，找到deploy配置项
- type 使用git
- repo 使用你github pages的全称，即https://github.com/name/name.github.io
- branch: 使用的分支名称，建议不要使用master/main，避免冲掉原分支代码
在上述流程配置完成后，可通过hexo g -d完成部署
在Github Pages Settings页面，可以配置deploy使用的分支名
至此，可以打开GitHub Pages查看最终的部署效果
后记
所有上述操作都可以在hexo官网查询
部分细节没有描述，过程的记录建立在一定的代码基础上