1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# macOS
brew install hugo

# Linux
sudo snap install hugo

# Windows
choco install hugo-extended

# 验证安装
hugo version

1
2
3
4
5
6
7
8
9

# 创建项目
hugo new site my-blog
cd my-blog

# 初始化 Git
git init

# 添加主题（以 PaperMod 为例）
git submodule add https://github.com/adityatelange/hugo-PaperMod themes/PaperMod

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

baseURL = "https://example.com"
languageCode = "zh-CN"
title = "我的博客"
theme = "PaperMod"

[params]
  description = "这是我的个人博客"
  author = "Your Name"

  [params.homeInfoParams]
    Title = "欢迎来到我的博客 👋"
    Content = "分享技术、记录生活"

[[menu.main]]
  name = "首页"
  url = "/"
  weight = 1

[[menu.main]]
  name = "文章"
  url = "/posts/"
  weight = 2

[[menu.main]]
  name = "归档"
  url = "/archives/"
  weight = 3

[[menu.main]]
  name = "关于"
  url = "/about/"
  weight = 4

1
2
3
4
5

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

# 编辑文章
vim content/posts/my-first-post.md

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

---
title: "我的第一篇文章"
date: 2025-10-17T10:00:00+08:00
draft: false
tags: ["Hugo", "博客"]
categories: ["技术"]
---

## 欢迎

这是我的第一篇博客文章！

### Markdown 语法示例

- 列表项 1
- 列表项 2

**粗体文本** 和 *斜体文本*

\`\`\`python
def hello():
    print("Hello, World!")
\`\`\`

1
2
3
4

# 启动开发服务器
hugo server -D

# 访问 http://localhost:1313

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

# 创建 .github/workflows/deploy.yml
name: Deploy Hugo site to Pages

on:
  push:
    branches: ["main"]

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4
        with:
          submodules: recursive

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v2
        with:
          hugo-version: 'latest'
          extended: true

      - name: Build
        run: hugo --minify

      - name: Upload artifact
        uses: actions/upload-pages-artifact@v2
        with:
          path: ./public

  deploy:
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    needs: build
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v2

1
2
3
4
5

git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/username/blog.git
git push -u origin main

1
2
3
4
5
6
7
8
9

[params.comments]
  enabled = true
  provider = "giscus"

  [params.comments.giscus]
    repo = "username/repo"
    repoId = "R_xxxxx"
    category = "Announcements"
    categoryId = "DIC_xxxxx"

1
2
3
4
5
6
7
8
9

[outputs]
  home = ["HTML", "RSS", "JSON"]

[params]
  [params.fuseOpts]
    isCaseSensitive = false
    shouldSort = true
    location = 0
    distance = 1000

1
2
3
4
5

[params.analytics]
  google = "G-XXXXXXXXXX"

[params.busuanzi]
  enabled = true

1
2
3
4
5
6

# 使用 WebP 格式
hugo gen chromaicstyles > assets/syntax.css

# CDN 加速
[params]
  cdn = "https://cdn.jsdelivr.net/gh/username/repo@main/"

1
2
3
4
5
6
7

[params]
  images = ["og-image.png"]

[params.schema]
  publisherType = "Person"
  publisherName = "Your Name"
  publisherLogo = "/logo.png"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

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

# 构建网站
hugo

# 本地预览
hugo server -D

# 清理缓存
hugo mod clean

# 查看帮助
hugo help