2026版：Hexo + GitHub Pages 个人博客搭建全记录
最近抽时间把个人博客重新搭建了一遍，依然选择的是 Hexo 配合 GitHub Pages 的经典方案。在搭建过程中，发现很多以前的教程随着软件版本的更迭已经不再适用了。这里将整个流程和遇到的一些报错记录下来，方便以后查阅。
阶段一：基础框架搭建 (Hexo + GitHub Pages)
博客的基础骨架搭建，我主要参考了这篇知乎经验贴：
🔗 参考教程：《Hexo + GitHub Pages 搭建个人博客》
💡 操作记录：
虽然这篇文章的整体逻辑很清晰，但因为发布时间较早，很多细节已经发生了变化。例如 Node.js 的版本要求、Hexo 包管理的变动，以及目前 GitHub 默认主分支已经从master变成了main。这些差异很容易导致按照原教程执行时出现报错。在实际操作中，如果遇到版本不兼容导致的报错，建议直接将终端报错信息交给大语言模型去分析，通常能很快定位并解决问题，能省下不少查阅旧资料的时间。
阶段二：配置专属独立域名
默认部署到 GitHub Pages 上的域名格式通常是 用户名.github.io。为了方便记忆和后续的扩展，我为博客绑定了一个专属的独立域名。
🔗 参考教程：《GitHub Pages 绑定自定义域名》
核心操作步骤：
- 域名购买：我在阿里云购买了一个
.top后缀的域名，相对来说性价比比较高。 - DNS 解析配置：进入阿里云控制台，添加一条
CNAME记录，将其解析指向自己的 GitHub Pages 地址。 - GitHub 仓库配置：在 GitHub 博客仓库的
Settings -> Pages -> Custom domain中填入刚购买的域名，并勾选开启Enforce HTTPS以保证访问安全。配置完成后，稍微等待 DNS 解析生效，就可以使用独立域名访问博客了。
阶段三：博客主题美化与自定义
原生的 Hexo 界面比较基础，为了提升页面的可读性和排版效果，通常需要对主题进行一定的自定义。
🔗 参考教程：《Hexo 博客主题深度美化指南》
我主要进行的配置和调整包括：
- 更换第三方主题（这里我尝试了经典的 NexT 等几款主流主题）。
- 配置侧边栏的个人信息、头像以及社交平台链接。
- 微调了博客的背景和字体配色，以改善正文内容的阅读体验。
- 补充了专属的网站标签页小图标（Favicon）。
整个流程走下来，算是一次比较完整的前端部署实践。一个功能完善、排版清晰的博客不仅能作为知识库，也是记录学习日常的好工具。