本地预览

本地预览

在部署到线上之前，先在本地预览博客效果。

启动本地服务器

1

hexo server

或者使用简写：

1

hexo s

默认在 http://localhost:4000 启动本地服务器。

指定端口

如果 4000 端口被占用，可以指定其他端口：

1

hexo server -p 5000

启用草稿预览

默认情况下，草稿（_drafts 目录下的文章）不会显示。要预览草稿：

1

hexo server --draft

实时刷新

Hexo 本地服务器支持实时刷新（LiveReload），修改文件后浏览器会自动更新。

但某些情况下需要手动清除缓存：

1
2

hexo clean
hexo server

常用开发流程

1
2
3
4
5
6
7
8
9
10

# 1. 新建文章
hexo new "我的新文章"

# 2. 编辑文章
# 使用你喜欢的编辑器打开 source/_posts/我的新文章.md

# 3. 预览效果
hexo server

# 4. 修改后保存，浏览器自动刷新

生成静态文件

如果不需要实时预览，只想生成静态文件：

1
2

hexo generate
# 简写：hexo g

生成的文件在 public/ 目录下，可以直接用任何 HTTP 服务器托管。

清除缓存

如果遇到页面没有更新或报错：

1

hexo clean

这会清除 public/ 目录和 .deploy_git/ 缓存。

常见问题

端口被占用

1

Error: listen EADDRINUSE: address already in use 0.0.0.0:4000

解决：换一个端口 hexo server -p 5000，或关闭占用 4000 端口的程序。

页面不更新

1
2

hexo clean
hexo server

找不到文章

检查文章的 Front Matter 中 published 字段是否为 false，如果是则不会发布。

💡 提示：本地预览时，所有链接都是相对于根路径 / 的。如果部署到子目录，需要在 _config.yml 中配置 root 字段。