Hexo 常用命令参考手册

本文档总结了 Hexo 博客框架最常用的命令行操作,帮助你更高效地管理博客。

一、基础命令

1.1 安装 Hexo CLI

1
2
# 全局安装 Hexo 命令行工具
npm install -g hexo-cli

1.2 初始化项目

1
2
3
4
5
# 在指定文件夹初始化 Hexo 网站
hexo init [folder]

# 示例:在当前目录初始化
hexo init

1.3 查看版本信息

1
2
# 显示 Hexo 版本及相关信息
hexo version

二、内容创建命令

2.1 创建新文章

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 基本语法
hexo new [layout] <title>

# 创建新文章(使用默认布局)
hexo new "我的第一篇文章"

# 创建草稿
hexo new draft "草稿文章"

# 创建页面
hexo new page "关于我"

# 创建页面并指定路径
hexo new page --path about/me "About me"

常用参数:

  • -p, --path: 自定义文件路径
  • -r, --replace: 替换现有文件
  • -s, --slug: 自定义 URL slug

2.2 发布草稿

1
2
3
4
5
# 将草稿移动到文章文件夹
hexo publish [layout] <filename>

# 示例
hexo publish draft "草稿文章"

三、生成与预览命令

3.1 生成静态文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
# 基本生成命令
hexo generate

# 简写形式
hexo g

# 生成后立即部署
hexo generate --deploy
hexo g -d

# 监听文件变化并自动重新生成
hexo generate --watch
hexo g -w

# 强制重新生成所有文件
hexo generate --force
hexo g -f

# 遇到错误时停止生成
hexo generate --bail
hexo g -b

# 设置并发数量(默认无限制)
hexo generate --concurrency 10
hexo g -c 10

3.2 启动本地服务器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# 启动本地开发服务器(默认 http://localhost:4000/)
hexo server

# 简写形式
hexo s

# 自定义端口
hexo server -p 8080
hexo s -p 5000

# 仅提供静态文件服务(不生成文件)
hexo server --static
hexo s -s

# 启用日志记录
hexo server --log "common"

# 显示草稿
hexo server --draft
hexo s -d

四、部署命令

4.1 部署网站

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# 基本部署命令
hexo deploy

# 简写形式
hexo d

# 生成后立即部署
hexo deploy --generate
hexo d -g

# 推荐的完整部署流程
hexo clean && hexo generate && hexo deploy
# 或简写
hexo clean && hexo g -d

五、清理与维护命令

5.1 清理缓存

1
2
# 清理缓存文件(db.json)和已生成的静态文件(public 文件夹)
hexo clean

5.2 列出路由

1
2
3
4
5
6
7
# 列出网站的所有路由
hexo list <type>

# 示例
hexo list post
hexo list page
hexo list route

六、高级命令

6.1 渲染文件

1
2
3
4
5
6
# 渲染指定文件
hexo render <file1> [file2] ...

# 指定输出目录
hexo render index.md -o output/
hexo render file.md -o _public

6.2 迁移内容

1
2
# 从其他博客系统迁移内容
hexo migrate <type>

6.3 配置管理

1
2
3
4
5
6
7
8
9
10
11
# 查看配置
hexo config [key]

# 查看主题配置
hexo config theme

# 设置配置值
hexo config [key] [value]

# 设置主题
hexo config theme landscape

七、全局选项

这些选项可以与任何命令一起使用:

7.1 自定义配置文件

1
2
3
4
5
6
7
8
# 使用自定义配置文件
hexo --config custom.yml

# 使用多个配置文件(后者优先级更高)
hexo --config custom.yml,custom2.json

# 示例:使用自定义配置启动服务器
hexo server --config custom.yml

7.2 安全模式

1
2
# 禁用所有插件和脚本(用于排查问题)
hexo --safe

7.3 调试模式

1
2
# 启用详细日志记录(输出到控制台和 debug.log 文件)
hexo --debug

7.4 静默模式

1
2
# 不显示任何输出
hexo --silent

7.5 显示草稿

1
2
# 在生成或预览时包含草稿文件
hexo --draft

7.6 自定义工作目录

1
2
# 指定不同的工作目录
hexo --cwd /path/to/cwd

八、常用命令组合

8.1 完整的发布流程

1
2
3
4
5
# 清理 -> 生成 -> 部署
hexo clean && hexo generate && hexo deploy

# 简写
hexo clean && hexo g -d

8.2 开发流程

1
2
# 清理后启动服务器并监听变化
hexo clean && hexo server --draft

8.3 快速预览

1
2
# 生成并启动服务器
hexo g && hexo s

8.4 调试模式生成

1
2
# 在调试模式下生成,便于排查问题
hexo generate --debug

九、命令别名速查表

完整命令 简写 说明
hexo generate hexo g 生成静态文件
hexo server hexo s 启动本地服务器
hexo deploy hexo d 部署网站
hexo new hexo n 创建新文章
hexo --draft hexo -d 显示草稿
hexo --generate hexo -g 生成(用于部署命令)

十、常见问题解决

10.1 清除缓存问题

如果遇到页面不更新的问题:

1
2
hexo clean
hexo generate

10.2 端口占用

如果 4000 端口被占用:

1
hexo server -p 5000

10.3 插件问题排查

如果怀疑是插件导致的问题:

1
hexo --safe

十一、推荐工作流

日常写作流程

1
2
3
4
5
6
7
8
9
10
# 1. 创建新文章
hexo new "文章标题"

# 2. 编辑文章(使用你喜欢的编辑器)

# 3. 本地预览
hexo clean && hexo server --draft

# 4. 发布
hexo clean && hexo g -d

主题开发流程

1
2
3
4
5
6
# 1. 清理并启动服务器,监听变化
hexo clean && hexo server --watch

# 2. 修改主题文件

# 3. 浏览器自动刷新查看效果

参考资源

提示: 将此文档保存为书签,随时查阅 Hexo 命令!