Hexo 常用命令大全

Hexo 是一款高效、简洁的静态博客框架。熟悉 Hexo 的常用命令可以大幅提升操作效率。本文将总结常用的 Hexo 命令，帮助你快速上手并优化操作流程。

安装 Hexo

在开始使用 Hexo 之前，确保你已安装 Node.js 和 npm。

初始化 Hexo 项目

npm install -g hexo-cli # 全局安装 Hexo CLI
hexo init <项目名>     # 初始化 Hexo 博客项目
cd <项目名>            # 进入项目目录
npm install            # 安装依赖

基础操作命令

以下是 Hexo 的基本操作命令：

清理项目

1	hexo clean

清理 Hexo 生成的静态文件和缓存，避免部署时可能出现的冲突。

生成静态文件

1	hexo generate

生成博客的静态文件，默认输出到 public/ 目录。

本地预览

1	hexo server

启动本地服务器，默认地址为 http://localhost:4000，用于预览博客效果。

实拍（2026-10-30，Hexo 7.3 / Butterfly 5.2.2）：本项目执行 npm run server -- --ip 127.0.0.1 后，在浏览器打开 http://127.0.0.1:4000/ 的首页。文章、封面和配色来自本项目，不是新建 Hexo 站点的默认内容。

确认页面能显示文章、主题样式和图片，才算完成浏览器端的初步检查；仅看到命令行提示启动成功还不够。若页面打不开，检查服务是否仍在运行以及端口是否与浏览器地址一致。

组合命令

1	hexo clean && hexo generate && hexo server

一次性清理、生成静态文件并启动本地服务。

文章管理命令

新建文章

1	hexo new post "文章标题"

在 source/_posts/ 目录下创建一篇新文章，并生成默认模板。

新建页面

1	hexo new page "页面名称"

在 source/ 目录下创建一个独立页面（例如：关于页、友链页）。

部署命令

部署到指定平台

1	hexo deploy

根据 _config.yml 文件中的 deploy 配置，将博客部署到远程服务器（例如 GitHub Pages）。

常用组合命令

1	hexo clean && hexo generate && hexo deploy

清理、生成并部署到指定平台。

高级操作命令

查看 Hexo 帮助

hexo help

查看 Hexo 支持的所有命令及其参数说明。

查看 Hexo 版本

1	hexo version

显示当前 Hexo 的版本号。

调试模式

1	hexo server --debug

开启调试模式，便于排查错误。

插件管理命令

安装插件

1	npm install <插件名> --save

例如安装 RSS 生成插件：

1	npm install hexo-generator-feed --save

卸载插件

1	npm uninstall <插件名>

常用场景组合命令

本地预览博客

1	hexo clean && hexo generate && hexo server

清理缓存、生成文件并预览。

更新博客并部署

1	hexo clean && hexo generate && hexo deploy

清理旧缓存、生成新静态文件并将其部署到远程。

总结

以上列举了 Hexo 常用的操作命令，从基础到进阶，涵盖了日常使用的各类场景。掌握这些命令后，可以更高效地管理和维护你的博客。如果你有其他 Hexo 使用相关的问题或需求，欢迎留言交流！