一份精简、实用的 Hugo 命令速查。


一、项目创建 & 初始化

# 1. 新建站点(在当前目录下创建 myblog 文件夹)
hugo new site myblog

# 2. 进入项目目录
cd myblog

# 3. 初始化主题模块(新版 Hugo 推荐)
hugo mod init github.com/你的用户名/你的仓库名

二、写文章(最常用)

# 新建一篇文章(自动生成 frontmatter,draft=true 草稿)
hugo new posts/第一篇文章.md

# 新建页面(如 about、contact)
hugo new about.md

三、本地预览(开发)

# 启动本地服务器,默认 http://localhost:1313,热更新
hugo server

# 🔥 常用:预览包含草稿(draft=true)的文章
hugo server -D

# 自定义端口(如 8080)
hugo server --port 8080

# 绑定到所有网卡(手机/局域网访问)
hugo server --bind 0.0.0.0

四、构建发布(生产)

# 构建静态文件到 public/(默认,不含草稿)
hugo

# 🔥 生产环境压缩(HTML/CSS/JS 最小化,推荐)
hugo --minify

# 构建并包含草稿(临时用)
hugo -D

# 指定输出目录(默认 public)
hugo -d ./dist

五、日常工作流(你用 GitHub Pages)

# 1. 写新文章
hugo new posts/xxx.md

# 2. 本地预览
hugo server -D

# 3. 确认后,把草稿改为正式:把 md 文件里 draft = false

# 4. 构建生产文件
hugo --minify

# 5. 提交到 Git 并推送
git add .
git commit -m "xxx"
git push

六、模块 & 主题管理(常用)

# 拉取主题/模块更新
hugo mod get -u

# 清理模块缓存(解决依赖报错)
hugo mod clean --all

# 整理 go.mod(删除无用依赖)
hugo mod tidy

七、排错 & 信息

# 查看版本
hugo version

# 查看帮助
hugo help
hugo server --help

# 列出所有草稿
hugo list drafts

# 清空 public 再构建(避免旧文件残留)
rm -rf public && hugo --minify

八、常用参数速查表

  • -D / --buildDrafts:包含草稿
  • --minify:压缩代码(生产必加)
  • --port 端口:自定义端口
  • -v:详细日志(排错用)