整理一下日常使用 Hexo 搭建博客时最常用的命令，方便随时查阅。

基础命令

新建文章

1
2
3
hexo new "我的新文章"
# 简写
hexo n "我的新文章"

执行后会在 source/_posts/ 目录下生成对应的 Markdown 文件，编辑该文件即可写作。

新建页面

1
hexo new page "about"

会在 source/about/ 下生成 index.md，常用于创建关于页、友链页等独立页面。

启动本地预览

1
2
3
4
5
hexo server
# 指定端口
hexo server -p 5000
# 简写
hexo s

默认访问 http://localhost:4000，修改文件后刷新浏览器即可看到最新效果，是最常用的调试方式。

生成静态文件

1
2
3
hexo generate
# 简写
hexo g

将 Markdown 文章渲染成静态页面，输出到 public/ 目录。

部署

1
2
3
hexo deploy
# 简写
hexo d

需要先在 _config.yml 中配置好 deploy 项，常用的是 git 部署方式。

常用组合

1
2
3
4
5
6
7
8
# 清理缓存后重新生成，改了配置或样式不生效时先执行这个
hexo clean && hexo g

# 一键生成并部署
hexo clean && hexo g && hexo d

# 本地预览草稿（默认草稿不渲染）
hexo s --draft

实用技巧

  • 修改不生效：改了主题或配置文件后页面没变化，先 hexo clean 清掉缓存再重新生成
  • 草稿功能：hexo new draft "标题" 创建草稿，写完执行 hexo publish "标题" 转正
  • 指定布局：hexo new photo "标题" 可以使用 scaffolds 里自定义的模板

Front-matter 常用字段

1
2
3
4
5
6
7
8
9
10
11
12
---
title: 文章标题
date: 2026-09-14 10:00:00
updated: 2026-09-14 12:00:00
tags:
  - Hexo
categories:
  - 博客搭建
cover: /images/cover.webp
description: 文章摘要
sticky: 100   # 置顶，数值越大越靠前
---

更多细节可以查阅 Hexo 官方文档。