📝 什么是 hugo.toml

hugo.toml 是 Hugo 博客的主配置文件，就像博客的"控制面板"，所有关于博客的设置都在这里调整。

🎯 基础配置

baseURL = 'https://example.org/'
title = 'Ah新的生活小札'
theme = 'PaperMod'
defaultContentLanguage = 'zh-cn'
配置项说明示例
baseURL博客的域名地址https://blog.ahxin.cn/
title博客名称Ah新的生活小札
theme使用的主题名称PaperMod
defaultContentLanguage默认语言zh-cn（简体中文）

📖 内容配置

enableRobotsTXT = true
enableEmoji = true
paginate = 10
summaryLength = 30
配置项说明
enableRobotsTXT生成搜索引擎爬虫文件（建议开启）
enableEmoji支持表情符号（✨👍🎉）
paginate每页显示多少篇文章
summaryLength文章摘要显示多少个单词

🎨 主题参数（[params]）

这部分是最重要的，控制博客的各种功能开关：

基本信息

[params]
  title = "Ah新的生活小札"
  description = "日常琐记 生活共赏"
  author = "ah新"

功能开关

ShowReadingTime = true      # 显示阅读时间
ShowShareButtons = true     # 显示分享按钮
ShowPostNavLinks = true     # 文章底部显示上一篇/下一篇
ShowBreadCrumbs = true      # 显示面包屑导航
ShowCodeCopyButtons = true  # 代码块显示复制按钮
ShowToc = true              # 文章目录（大纲）
TocOpen = true              # 目录默认展开

主题切换

defaultTheme = "auto"       # 自动跟随系统（light/dark）
disableThemeToggle = false  # 允许手动切换明暗模式

首页模式

homeInfoParams = { enabled = true, Title = "你好，我是 ah新", Content = "日常琐记，生活共赏 ✨" }

三种首页模式：

  • Regular（默认）：直接显示文章列表
  • Profile：头像+简介+按钮（个人主页风格）
  • Home-Info：简短介绍+文章列表（当前使用）

封面图

[params.cover]
  hiddenInList = true       # 文章列表中隐藏封面图

🔗 导航菜单（[menu]）

[menu]
  [[menu.main]]
    identifier = "关于"      # 唯一标识
    name = "关于"           # 显示名称
    url = "/about/"         # 链接地址
    weight = 10             # 排序权重（数字越小越靠前）

weight 决定菜单顺序，数字越小越在左边：

  • weight = 10 → 第一个
  • weight = 20 → 第二个
  • weight = 30 → 第三个

🌍 多语言配置（[languages]）

[languages]
  [languages.zh-cn]
    label = "简体中文"
    weight = 1

如果博客只有中文，可以不用管这部分。

📊 其他常用配置

压缩优化

[minify]
  disableXML = true
  minifyOutput = true

开启后会自动压缩 HTML/CSS/JS 文件，让网站加载更快。

输出格式

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

控制首页输出哪些文件格式，默认即可。

📁 项目结构

你的博客/
├── hugo.toml              # 配置文件
├── content/               # 文章内容
│   ├── about.md           # 关于页
│   ├── search.md          # 搜索页
│   └── posts/             # 文章目录
│       └── 文章文件名.md
├── static/                # 静态资源
│   ├── admin/             # Decap CMS
│   ├── uploads/           # 上传的图片
│   └── avatar.png         # 头像
└── themes/                # 主题
    └── PaperMod/          # PaperMod 主题

💡 修改配置后怎么生效

修改 hugo.toml 后：

  1. 如果是 hugo server 运行中，会自动重新加载
  2. 如果是静态构建，重新运行 hugo 命令

🎯 常用命令

# 启动本地预览（开发用）
hugo server -D

# 构建静态文件（部署用）
hugo

# 新建文章
hugo new posts/文章标题.md

# 新建页面
hugo new about.md

总结：hugo.toml 就是博客的设置中心，你想改什么就在这里找对应的配置项。改完保存，刷新页面就能看到效果！