Hugo 博客搭建与 IMX 主题完全使用指南

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

这篇指南带你从空目录走到一个能本地预览的 IMX 博客。完成后，你会知道站点文件放在哪里、怎样写文章，以及修改后该检查什么。已有 Hugo 站点的读者可以直接看 IMX 主题配置指南；准备上线时再看 GitHub Pages 部署指南。

开始前需要什么

安装 Git、Go 和 Hugo Extended。IMX 通过 Hugo Module 加载，主题示例站给出的最低要求是 Hugo Extended 0.112.0 与 Go 1.20；新项目建议让本地与 CI 使用经过验证的相同版本。

hugo version
go version
git --version

确认 hugo version 的输出包含 extended。建站和写作不需要安装 Node.js；主题仓库里的前端测试依赖只用于维护主题。

1. 创建站点并安装主题

以下以 my-blog 为目录名，your-name 为 GitHub 用户名。请替换这两个占位符。

hugo new site my-blog
cd my-blog
git init
hugo mod init github.com/your-name/my-blog

在根目录的 hugo.toml 写入最小配置：

baseURL = 'https://your-name.github.io/'
defaultContentLanguage = 'zh-cn'
locale = 'zh-CN'
title = '我的博客'

[params]
 description = '记录技术与生活'
 subtitle = '把值得记住的事写下来'
 author = '你的名字'
 mainSections = ['posts']

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

[module]
 [module.hugoVersion]
 extended = true
 min = '0.112.0'
 [[module.imports]]
 path = 'github.com/c-x-x/hugo-theme-imx'

安装一个明确的主题版本。例如，本站当前使用 v1.5.6：

博客搭建 on IMX-博客

Hugo 博客搭建与 IMX 主题完全使用指南

开始前需要什么

1. 创建站点并安装主题