Hexo常见命令快速指南

Welcome to Hexo!
Check documentation for more info. If you get any problems when using Hexo, you can find the answer in troubleshooting or you can ask me on GitHub.
1、init
1 | $ hexo init [folder] |
新建一个网站。 如果没有设置 folder
,Hexo 默认在目前的文件夹建立网站。
本命令相当于执行了以下几步:
- Git clone hexo-starter 和 hexo-theme-landscape 主题到当前目录或指定目录。
- 使用 Yarn 1、pnpm 或 npm 包管理器下载依赖(如有已安装多个,则列在前面的优先)。 npm 默认随 Node.js 安装。
2、new
1 | $ hexo new [layout] <title> |
新建一篇文章。 如果没有设置 layout
的话,默认使用 _config.yml 中的 default_layout
参数代替。 使用布局 draft
来创建草稿。 如果标题包含空格的话,请使用引号括起来。
选项 | 描述 |
---|---|
-p , --path |
文章的路径。 自定义文章的路径。 |
-r , --replace |
如果存在的话,替换当前的文章。 |
-s , --slug |
文章别名。 自定义文章的 URL。 |
默认情况下,Hexo 会使用文章的标题来决定文章文件的路径。 对于独立页面来说,Hexo 会创建一个以标题为名字的目录,并在目录中放置一个 index.md
文件。 你可以使用 --path
参数来覆盖上述行为、自行决定文件的目录:
1 | hexo new page --path about/me "About me" |
以上命令会创建一个 source/about/me.md
文件,同时 Front Matter 中的 title 为 "About me"
注意! title 是必须指定的! 例如,这不会产生您可能期望的行为:
1 | hexo new page --path about/me |
此时 Hexo 会创建 source/_posts/about/me.md
,同时 me.md
的 Front Matter 中的 title 为 "page"
。 这是因为在上述命令中,hexo-cli 将 page
视为指定文章的标题、并采用默认的 layout
。
3、generate
1 | $ hexo generate |
生成静态文件。
选项 | 描述 |
---|---|
-d , --deploy |
在生成完成后部署。 |
-w , --watch |
监视文件变动 |
-b , --bail |
生成过程中如果发生任何未处理的异常则抛出异常 |
-f , --force |
强制重新生成 |
-c , --concurrency |
要同时生成的文件的最大数量。 默认无限制 |
4、publish
1 | $ hexo publish [layout] <filename> |
发表草稿。
5、server
1 | $ hexo server |
启动服务器。 默认情况下,访问网址为: http://localhost:4000/
。
选项 | 描述 |
---|---|
-p , --port |
重设端口 |
-s , --static |
只使用静态文件 |
-l , --log |
启用日志。 Override logger format. |
6、deploy
1 | $ hexo deploy |
部署你的网站。
选项 | 描述 |
---|---|
-g , --generate |
在部署前生成 |
7、migrate
1 | $ hexo migrate <type> |
从其他博客系统 迁移内容。
8、clean
1 | $ hexo clean |
清除缓存文件 (db.json
) 和已生成的静态文件 (public
)。
9、list
1 | $ hexo list <type> |
列出所有路由。
10、version
1 | $ hexo version |
显示版本信息。
11、config
1 | $ hexo config [key] [value] |
列出网站的配置(_config.yml
)。 如果指定了 key
,则只展示配置中对应 key
的值;如果同时指定了 key
和 value
,则将配置中对应的 key
的值修改为 value
。
Quick Start
Create a new post
1 | $ hexo new "My New Post" |
More info: Writing
Run server
1 | $ hexo server |
More info: Server
Generate static files
1 | $ hexo generate |
More info: Generating
Deploy to remote sites
1 | $ hexo deploy |
More info: Deployment
- 标题: Hexo常见命令快速指南
- 作者: xuliyaoPro
- 创建于 : 2025-06-01 00:00:00
- 更新于 : 2025-06-01 00:00:00
- 链接: https://chinapmcc.com/2025/06/01/网站建设/Hexo常见命令快速指南/
- 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。