😎 手把手教你部署Hexo博客：从懵逼到成功全记录
"搞博客不装X，那将毫无意义！" —— 鲁迅（并没有说过）
🚀 前言：为啥选Hexo？
- ⚡ 速度贼快：生成500篇文章只要3秒，比你家猫跳上键盘的速度还快（我只能说就抽象这块，那还得是Deepseek）
- 🆓 完全白嫖：GitHub Pages免费托管，连域名钱都省了（真香）
- 📱 手机都能写：Markdown语法简单到抠脚，地铁上掏出手机就能码字
废话不多说，开整！
🔧 1. 环境准备：先把家伙事儿备齐
1.1 装Node.js（发动机）
# Mac老铁
brew install node
# Windows老哥（管理员模式运行CMD）
https://nodejs.org/zh-cn
# Linux大佬
sudo apt-get install nodejs npm💡 装完记得验货：
node -v # 显示版本号就对了
npm -v # 同上 1.2 装Git（传送门）
👉 git-scm.com 直接下就完事了
装完打开终端验货：
git --version
# 出现 git version x.x.x 说明安装成功 1.3 配置Git身份（重要！）
git config --global user.name \"你的ID\"
git config --global user.email \"你的邮箱\"
# 比如：
# git config --global user.name \"TonyStark\"
# git config --global user.email \"tony@stark.com\" 💻 2. Hexo安装：三行代码搞定
2.1 安装Hexo本体
npm install hexo-cli -g # -g表示全局安装 2.2 创建博客文件夹
hexo init my-cool-blog # 名字随便起，别用中文！
cd my-cool-blog # 进入这个文件夹
npm install # 安装依赖 2.3 本地预览（见证奇迹时刻）
hexo s # s是server的缩写 浏览器打开 http://localhost:4000 👉 恭喜你！已经能看到默认博客了！
🚨 重点提醒：
按
Ctrl+C可以停止服务！别傻乎乎关终端！
🎨 3. 主题美化：换个皮肤
3.1 安装Butterfly主题（颜值担当）
git clone https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly 3.2 启用主题
打开 _config.yml 文件（根目录下），找到 theme 改成：
theme: butterfly 3.3 基础配置（装X必备）
在根目录新建 _config.butterfly.yml 文件，复制下面配置：
# ---------- 装X基础配置 ----------
title: 老王的基地 # 改成你的博客名
subtitle: 这里不生产代码，只生产装X # 副标题
description: \"野生程序员 | 深夜思想家 | 白日梦想家\" # 简介要中二
# ---------- 导航菜单 ----------
menu:
Home: / || fas fa-home
Archives: /archives/ || fas fa-archive
Tags: /tags/ || fas fa-tags
About: /about/ || fas fa-user
# ---------- 装X特效 ----------
typed:
enable: true # 开启打字机特效
strings:
- \"正在加载装X能量...\"
- \"逼格充值中，请稍候...\"
- \"警告：前方高能装X！\"
github_corner: true # 显示GitHub小挂件 ✍️ 4. 写第一篇博客：开始你的表演
4.1 创建新文章
hexo new \"老子终于搞定了Hexo\" 4.2 编辑文章（重点！）
打开 source/_posts/老子终于搞定了Hexo.md，改成这样：
---
title: 老子终于搞定了Hexo！
date: 2025-07-18
tags:
- 装X教程
- Hexo
categories: 技术
cover: /images/zhuangbi.jpg
---
## 😤 搞Hexo的血泪史
> **\"装X路上最大的敌人就是自己的手残\"**
### 踩坑实录：
1. **环境变量没配好** → 重装三次Node.js
2. **主题配置搞错** → 熬夜到凌晨三点
3. **部署失败** → 怒删仓库重来 💥 最终效果
看！这就是lz的博客：
友情提示：装X虽爽，但记得备份！建议用GitHub保存代码
🚀 5. 部署到GitHub：外部访问
5.1 创建GitHub仓库
名字必须叫：<你的GitHub用户名>.github.io
比如用户名叫 zhangsan，仓库就叫 zhangsan.github.io
5.2 安装部署插件
npm install hexo-deployer-git --save 5.3 配置部署信息
打开根目录的 _config.yml，拉到最下面添加：
deploy:
type: git
repo: https://github.com/<你的用户名>/<你的用户名>.github.io.git
branch: main
message: \"更新：{{ now(\'YYYY-MM-DD HH:mm:ss\') }}\" 5.4 一键三连部署
hexo clean # 清缓存
hexo g # 生成静态文件
hexo d # 部署到GitHub 等待1分钟后，访问 https://<你的用户名>.github.io 👉 见证奇迹时刻！
🚨 6. 常见翻车现场
| 翻车症状 | 抢救方案 |
|---|---|
ERROR Deployer not found: git |
重新运行 npm install hexo-deployer-git --save |
| 本地正常，上线样式全无 | 检查 _config.yml 里的 url 和 root 配置 |
| 图片不显示 | 在 _config.yml 加：post_asset_folder: true |
| 修改不生效 | 祭出终极奥义：hexo clean && hexo g |
| GitHub Pages报404 | 检查仓库名是否 <用户名>.github.io |
🎓 7. 毕业典礼
恭喜你成功晋级为：
最后送装X三件套：
- 备份命令：
git init+git add .+git commit -m \"存档\" - 更新命令：写完文章就运行
hexo clean && hexo g -d - 装X链接：
https://<你的用户名>.github.io甩到相亲相爱一家人群里
终极忠告：
博客不更新，装X等于零！
赶紧去写第二篇吧铁子！💪🏻
<center>🔥 <strong>装X有风险，入坑需谨慎！但真特么爽啊！</strong> 🔥</center>
🚢 下期预告
"优雅的美化Hexo+Butterfly"
- 修改导航栏菜单
- 创建相关的页面
- 魔改友情链接页面（默认的简直不要太丑）
评论