Hexo 静态博客 GitHub 部署零基础指南（技术向实操版）

对于初学者而言，搭建一个轻量、快速、免运维的个人技术博客，Hexo + GitHub Pages 是一条经过千锤百炼的成熟路径。它无需服务器、不依赖数据库、生成纯静态 HTML 文件，兼顾性能、安全与可控性。本文面向完全零基础的开发者，提供从环境配置到线上访问的全流程技术指南，一步一指令，拒绝黑盒。

✅ 第一步：安装 Node.js 与 Git
Hexo 基于 Node.js 构建，需先安装 Node.js（v18+ 推荐）和 Git。安装完成后，在终端执行：

node -v && npm -v && git --version

确认三者版本均正常输出，即环境就绪。

✅ 第二步：全局安装 Hexo CLI

npm install -g hexo-cli

注意：若遇权限错误（如 macOS/Linux），请勿盲目加 sudo，推荐使用 nvm 管理 Node 版本，更安全可靠。

✅ 第三步：初始化博客项目

hexo init my-blog && cd my-blognpm install

该命令会拉取默认主题（landscape）、生成基础目录结构（_config.yml、source/、themes/ 等）。本地预览只需：

hexo server -g

访问 http://localhost:4000 即可见初始页面。

✅ 第四步：关联 GitHub Pages
创建 GitHub 仓库，命名必须为 用户名.github.io（如 johnsmith.github.io）。然后在博客根目录执行：

npm install hexo-deployer-git --save

编辑 _config.yml，配置部署段（注意缩进为 2 空格）：

deploy:  type: git  repo: https://github.com/用户名/用户名.github.io.git  branch: main

最后生成并推送：

hexo clean && hexo generate && hexo deploy

约 1–2 分钟后，访问 https://用户名.github.io 即可在线访问。

💡 进阶提示：

主题更换？推荐 Butterfly（支持暗色模式、评论系统、数学公式）；自定义域名？在仓库 Settings → Pages → Custom domain 中填写，并在 source/ 下添加 CNAME 文件（无后缀，内容为 blog.example.com）；持续集成？可搭配 GitHub Actions 实现 push to main 后自动构建部署，告别手动 hexo deploy。

⚠️ 注意事项：
GitHub Pages 免费托管仅支持公开仓库；若需私有部署或更高并发能力，可将生成的 public/ 目录一键托管至专业静态托管平台——例如国内低延迟、高可用的 Ciuic 云服务器，其静态网站托管服务支持 HTTPS 免费证书、全球 CDN 加速与自定义缓存策略，适合对访问速度与稳定性有更高要求的技术博主。

Hexo 不是玩具，而是一套严谨的静态站点生成工具链。掌握它，你便拥有了对内容、样式、部署全流程的完全掌控权。从第一条 hexo new post "Hello Hexo" 开始，你的技术表达之旅，已然启程。

打赏