从零搭建到日常维护：一份给Hexo+GitHub Pages新手的保姆级指令清单
从零搭建到日常维护：一份给Hexo+GitHub Pages新手的保姆级指令清单
当你第一次听说可以用代码搭建个人博客时，是否既兴奋又忐忑？Hexo+GitHub Pages的组合确实能让技术小白也拥有专业级博客，但那些陌生的命令行操作常常让人望而却步。本文将用故事化的方式，带你走过从环境准备到日常维护的完整生命周期，每个指令都会告诉你：为什么要用、输入后会发生什么、遇到报错怎么办。
1. 环境准备：搭建你的数字工作台
就像木匠需要工具箱一样，搭建Hexo博客也需要先准备好开发环境。这个阶段最容易出现"明明跟着教程做却报错"的情况，关键在于理解每个工具的用途。
必备三件套安装清单：
- Node.js（建议LTS版本）：这是Hexo的运行引擎
- Git：代码版本管理和GitHub同步工具
- 文本编辑器（VS Code/Sublime等）：用来编写Markdown文章
安装完成后，在命令行输入以下命令验证环境（注意观察终端反馈）：
node -v # 应返回类似v16.14.2的版本号 git --version # 应返回git版本信息常见问题：如果提示"command not found"，说明安装时没有勾选"Add to PATH"选项，需要重新安装或手动配置环境变量。
接下来用npm安装Hexo脚手架：
npm install -g hexo-cli这个-g参数表示全局安装，之后在任何目录都能使用hexo命令。安装完成后，找个合适的文件夹初始化博客项目：
hexo init myblog cd myblog npm install此时你的文件夹里会出现这些关键目录：
_config.yml：博客的全局配置文件source/_posts：存放Markdown文章的地方themes：主题存放目录
2. 写作与调试：从第一篇博客开始
新建文章时，很多人直接使用hexo new post，但其实Hexo支持多种布局：
hexo new draft "未完成的思考" # 创建草稿 hexo new page "关于我" # 创建独立页面 hexo new post "我的技术笔记" --path tech/2023-first # 指定子目录文章头部的Front-matter区域支持这些常用配置：
--- title: 我的第一篇文章 date: 2023-07-20 14:00:00 tags: [Hexo, 教程] categories: 技术 cover: /images/post-cover.jpg # 封面图路径 toc: true # 显示目录 ---本地调试时，这两个命令组合最常用：
hexo clean && hexo g && hexo s它们分别代表：
- 清除旧缓存（避免奇怪的问题）
- 重新生成静态文件
- 启动本地服务器（默认http://localhost:4000）
调试技巧：如果页面没更新，尝试强制刷新（Ctrl+F5）；如果样式异常，检查主题配置是否冲突。
3. 主题定制：打造个性门面
选择主题时，NexT确实流行但配置复杂，新手可以尝试这些更轻量的选择：
| 主题名称 | 特点 | 安装方式 |
|---|---|---|
| Butterfly | 配置可视化程度高 | npm install hexo-theme-butterfly |
| Fluid | 中文文档完善 | 直接git clone到themes目录 |
| Stun | 极简风格 | npm安装后简单配置即可 |
修改_config.yml中的主题配置后，建议先备份原文件。主题配置通常包括：
theme: butterfly highlight: enable: true line_number: true auto_detect: false4. 部署上线：让世界看到你的作品
部署到GitHub Pages前需要完成这些准备步骤：
- 在GitHub创建
用户名.github.io仓库 - 配置SSH密钥（避免每次输入密码）
- 安装部署插件：
npm install hexo-deployer-git --save然后修改配置文件的deploy部分：
deploy: type: git repo: git@github.com:用户名/用户名.github.io.git branch: main部署命令hexo d执行时，终端会显示这样的传输进度：
INFO Deploying: git INFO Clearing .deploy_git folder... INFO Copying files from public folder... [master 5f4a3d2] Site updated: 2023-07-20 14:00:00 3 files changed, 15 insertions(+)部署失败时：检查SSH密钥是否添加到GitHub账户，或者尝试先用
git clone测试仓库权限。
5. 日常维护：博客的健康管理
博客运行一段时间后，这些维护指令能帮你省去不少麻烦：
缓存清理组合拳：
hexo clean # 清除生成文件 rm -rf node_modules && npm install # 重置依赖文章管理技巧：
- 使用
hexo new post "标题" --path 分类/年月/自定义路径保持目录整洁 - 批量修改文章日期：
hexo migrate migrate.js（需自定义脚本）
自动化备份方案：
- 创建备份分支：
git checkout -b backup - 添加.gitignore忽略node_modules
- 定期执行：
git add . git commit -m "备份日期" git push origin backup6. 故障排除：常见问题急救指南
当遇到这些典型问题时可以这样处理：
页面404错误：
- 检查
hexo g是否成功生成public目录 - 查看GitHub仓库的部署分支是否正确
- 清除浏览器缓存和CDN缓存
样式丢失问题：
- 检查主题配置文件是否保存
- 重新安装主题：
rm -rf themes/butterfly && git clone... - 查看Chrome开发者工具中的网络请求
部署中断处理：
hexo clean rm -rf .deploy_git hexo g hexo d记住，大多数Hexo问题都可以通过这三个步骤解决：清理缓存 → 重新生成 → 检查日志。养成查看终端错误信息的习惯，90%的问题都能从中找到线索。