Hugo 命令速查（建议收藏）

这是最常用的命令，放在最前面方便查阅。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 本地预览（包含 draft 草稿）
hugo server -D

# 指定端口
hugo server -D -p 1314

# 自动打开浏览器
hugo server -D --openBrowser

# 生成 public 目录（部署前必做）
hugo

# 清空目标目录后重新生成
hugo --cleanDestinationDir

# 创建新文章
hugo new posts/my-first-post.md

# 查看版本
hugo version

# 查看帮助
hugo help

1. Hugo 是什么

Hugo 是一个静态网站生成器。你负责写 Markdown，Hugo 负责把它们转换成 HTML、CSS、JS 等网页文件，最终输出到 public 目录，再部署到服务器即可。

它的特点：

  • 编译速度快
  • 不需要数据库
  • 适合博客、文档、个人主页
  • Markdown 原生支持
  • Git 管理方便

2. 安装

Windows

下载 Hugo Extended 版本，解压后将 hugo.exe 加入 PATH。

验证：

1

hugo version

macOS

1
2

brew install hugo
hugo version

Ubuntu / Debian

1
2

sudo apt update
sudo apt install hugo

3. 创建站点

1
2

hugo new site my-blog
cd my-blog

站点创建后会出现 content、layouts、static、themes 等目录。

4. 常见目录

目录 作用

content 文章 themes 主题 static 静态资源 assets 需要 Hugo 处理的资源 layouts 页面模板 public 最终生成的网站，请勿手动修改 resources 缓存文件

5. 写文章

1

hugo new posts/hello-world.md

Front Matter 示例：

1
2
3
4
5
6
7
8
9

---
title: "Hello Hugo"
date: 2026-07-12
draft: true
tags:
  - Hugo
categories:
  - Blog
---

开发阶段使用 hugo server -D 可以看到 draft 文章；发布前建议把 draft: false。

6. 本地预览

1

hugo server -D

默认访问：

http://localhost:1313

修改 Markdown 后通常会自动刷新。

7. 图片与静态资源

推荐结构：

1
2
3
4

content/posts/文章.md
content/posts/images/
content/posts/videos/
content/posts/others/

文章中引用：

1

![示例](images/demo.png)

视频和其它附件可按相对路径引用。

8. 构建与部署

执行：

1

hugo

生成：

1

public/

部署时上传 public 中的内容即可，不要上传整个项目。

典型流程：

  1. 写文章
  2. hugo server -D 本地检查
  3. hugo
  4. 上传 public 到服务器
  5. Nginx 指向 public

9. 常见问题

页面没有更新

重新执行：

1

hugo

看不到文章

检查：

  • 是否放在 content 下
  • 是否 draft: true
  • 本地是否使用 -D

图片不显示

检查：

  • 路径是否正确
  • 文件名大小写
  • 图片是否放到对应目录

10. 建议工作流

  • 使用 Obsidian 写 Markdown
  • 每篇文章配套 images / videos / others
  • 本地使用 hugo server -D
  • 发布前执行 hugo
  • 上传 public 到服务器
  • 使用 Git 管理整个项目

11. 常用命令汇总

1
2
3
4
5
6
7
8
9

hugo
hugo server
hugo server -D
hugo server --disableFastRender
hugo server -D --openBrowser
hugo new posts/test.md
hugo version
hugo env
hugo help

总结

记住三个核心命令即可：

1
2
3
4
5
6
7
8

# 开发
hugo server -D

# 打包
hugo

# 新建文章
hugo new posts/文章名.md

当你理解了 content 是输入、public 是输出 的概念后，Hugo 的工作流程就会非常清晰。