Hexo配置

Hexo 安装教程（小白快速上手版）

Hexo 是一个快速、简洁且高效的博客框架，基于 Node.js 构建。用 Markdown 写文章，Hexo 帮你生成漂亮的博客网页。

本教程只教你一件事：装好 Hexo，跑起来默认主题。简单直接，不扯复杂的。

---

目录

• Hexo 安装教程（小白快速上手版）
  • 目录
  • 一、环境要求
  • 二、安装 Node.js
    • 验证安装
  • 三、安装 Git
    • 验证安装
    • 首次配置（只做一次）
  • 四、安装 Hexo
    • 验证安装
  • 五、配置国内镜像加速（推荐）
  • 六、创建并预览博客
    • 6.1 新建博客文件夹
    • 6.2 初始化博客
    • 6.3 安装依赖
    • 6.4 生成静态网页
    • 6.5 启动本地服务器
    • 6.6 浏览器查看
  • 七、常用命令速查
  • 常见问题

---

一、环境要求

项目	要求
操作系统	Windows 10/11、macOS、Linux
Node.js	14.0 及以上（推荐 20.x LTS）
Git	2.x 或更高版本

这两样是 Hexo 运行的必备环境，Mac/Linux 一般自带 Git。

---

二、安装 Node.js

下载地址： https://nodejs.org/zh-cn/download

选择 LTS（长期支持版） 下载。

• Windows：下载 .msi，双击安装，一路 Next 即可（确保勾选 “Add to PATH”）
• macOS：下载 .pkg，或用 brew install node
• Linux：用包管理器，如 sudo apt install nodejs npm

验证安装

打开终端，输入：

node -v
# 输出示例：v20.20.2

npm -v
# 输出示例：10.8.2

✅ 看到版本号 = 安装成功。

如何打开终端？

• Windows：按 Win + R，输入 cmd 回车
• macOS：启动台搜索 “终端”
• Linux：Ctrl + Alt + T

---

三、安装 Git

下载地址： https://git-scm.com/downloads

• Windows：下载安装包，一路 Next
• macOS：brew install git（系统通常自带，可先跳过）
• **Linux (Ubuntu/Debian)**：sudo apt-get install git-core
• **Linux (Fedora/CentOS)**：sudo yum install git-core

验证安装

git --version
# 输出示例：git version 2.45.0

首次配置（只做一次）

git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

---

四、安装 Hexo

打开终端，执行一行命令：

npm install -g hexo-cli

-g 表示全局安装，装完后能在任何文件夹使用 hexo 命令。

验证安装

hexo -v

看到 Hexo 版本信息就说明装好了。🎉

如果安装很慢或失败，先看下一节配置镜像源。

---

五、配置国内镜像加速（推荐）

国内访问 npm 默认服务器（在国外）很慢，强烈建议先切换到淘宝镜像源。

# 设置为淘宝镜像源
npm config set registry https://registry.npmmirror.com

# 验证是否切换成功
npm config get registry
# 应输出：https://registry.npmmirror.com

切换后重新安装 Hexo，速度会快很多：

npm install -g hexo-cli

懒人写法：不想改全局配置的话，可以临时指定：

npm install -g hexo-cli --registry=https://registry.npmmirror.com

---

六、创建并预览博客

6.1 新建博客文件夹

mkdir hexo-blog
cd hexo-blog

也可以在资源管理器里手动新建文件夹，再用 cd 命令进入。

6.2 初始化博客

hexo init

第一次执行可能稍慢（要下载依赖），耐心等几分钟。

6.3 安装依赖

npm install

6.4 生成静态网页

hexo g
# 完整命令：hexo generate

6.5 启动本地服务器

hexo s
# 完整命令：hexo server

6.6 浏览器查看

打开浏览器，访问：

http://localhost:4000

你就能看到 Hexo 默认主题的博客首页了！🎉

停止服务器：回到终端按 Ctrl + C。

---

七、常用命令速查

命令	简写	作用
npm install -g hexo-cli	-	全局安装 Hexo
hexo init	-	初始化博客
npm install	-	安装博客依赖
hexo generate	hexo g	生成静态网页
hexo server	hexo s	启动本地预览（端口 4000）
hexo clean	-	清除缓存（出问题时用）
hexo -v	-	查看 Hexo 版本

💡 记住这一串就够了：hexo clean && hexo g && hexo s（清缓存 + 生成 + 预览）

---

常见问题

Q：hexo: command not found？
A：Node.js 安装时没勾选 “Add to PATH”，重新安装 Node.js 即可。

Q：localhost:4000 打不开？
A：换端口启动 hexo s -p 5000，然后访问 http://localhost:5000。

Q：安装 Hexo 很慢/超时？
A：配置淘宝镜像源（看第五节），再重装。

---

参考资料

• Hexo 官方文档：https://hexo.io/zh-cn/docs/
• Node.js 官网：https://nodejs.org/zh-cn/
• Git 官网：https://git-scm.com/downloads