Hugo Theme IMX 主题配置指南

Tue, 07 Jul 2026 10:00:00 +0800

IMX 是一个通过 Hugo Module 使用的中文博客主题。它不需要放进 themes/ 目录，也不需要在配置里写 theme = "..."，站点通过 Go Module 引入主题，然后由 Hugo 在构建时合并主题模板、资源和默认配置。

这篇文章不讲“从零认识 Hugo”，只讲一件事：如何把 IMX 主题配置清楚。如果你已经有一个 Hugo 站点，照着本文检查一遍，基本可以把首页、文章列表、关于页、评论、搜索、图片和部署流程都理顺。

一、配置文件放在哪里

站点的主配置文件一般是根目录下的 hugo.toml：

your-site/
├── content/
├── static/
├── go.mod
├── go.sum
└── hugo.toml

IMX 主题推荐把主要配置都写在 hugo.toml 里。除非站点规模很大，否则没有必要一开始就拆成多个配置文件。

一个可以工作的最小配置如下：

baseURL = 'https://example.com/'
defaultContentLanguage = 'zh-cn'
locale = 'zh-CN'
title = '我的博客'

[params]
 description = '站点描述'
 subtitle = '首页副标题'
 author = '你的名字'
 mainSections = ['posts']

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

[module]
 [[module.imports]]
 path = 'github.com/c-x-x/hugo-theme-imx'

这几项先不要省：

baseURL：站点最终访问地址，影响 canonical、RSS、Open Graph 图片地址。
title：站点标题，会出现在导航、首页、关于页和网页标题里。
[params]：主题参数区，IMX 的头像、Logo、默认图片、评论、社交链接都在这里配置。
[outputs].home：必须保留 JSON，站内搜索依赖首页生成的 index.json。
[module.imports]：主题通过 Hugo Module 引入，不能用传统 theme = "xxx"。

二、安装与更新主题

如果站点还没有 go.mod，先执行：

博客 on IMX-博客

Hugo Theme IMX 主题配置指南

一、配置文件放在哪里

二、安装与更新主题