Hugo 命令速记
一、Hugo 本地预览（开发调试）
基础预览命令：
hugo server
常用参数：
hugo server -D
参数说明：
- server 启动本地 HTTP 服务
- -D 包含草稿（draft: true）的文章
- -F 包含未来时间（date 在未来）的文章
- -E 包含已过期（expiryDate）的文章
指定端口：
hugo server -p 1313
指定监听地址（局域网访问）：
hugo server --bind 0.0.0.0 --baseURL http://192.168.1.100/
禁用缓存（主题或样式调试用）：
hugo server --disableFastRender
二、Hugo 打包 / 生成静态站点
基础打包命令：
hugo
生成目录：
public/
清理后再生成：
hugo --cleanDestinationDir
指定环境：
hugo --environment production
三、常见组合命令
开发预览（最常用）：
hugo server -D --disableFastRender
正式发布打包：
hugo --cleanDestinationDir
四、CI / 自动化常用命令
无交互生成：
hugo --minify
指定配置文件：
hugo --config config.toml
多配置文件：
hugo --config config.toml,config.prod.toml
五、常见问题
1. 预览能看到，打包后没有？
原因：
- 文章是 draft: true
- 文章日期在未来
解决：
- 发布前去掉 draft
- 或打包时加： hugo -D -F
2. public 目录需要提交吗？
建议：
- 直接部署 → 不提交 public
- 纯静态托管 → 提交 public
六、命令速查表
| 场景 | 命令 |
|---|---|
| 本地预览 | hugo server |
| 预览草稿 | hugo server -D |
| 局域网预览 | hugo server –bind 0.0.0.0 |
| 打包生成 | hugo |
| 清理生成 | hugo –cleanDestinationDir |
| 压缩资源 | hugo –minify |