Hugo 0.17+ 原生支持多语言功能，若编译时出现 function "i18n" not defined 错误，通常因使用旧版 Hugo（
hugo 0.17+ 原生支持多语言功能，若编译时出现 `function "i18n" not defined` 错误，通常因使用旧版 hugo（
Hugo 自 0.17 版本起正式将多语言（i18n）支持合并进主干，并作为核心功能稳定提供。此前（如问题中所提）依赖第三方分支（如 abourget/master）的临时方案已失效——该分支早已被移除，且相关 PR 已完成合并。因此，解决 function "i18n" not defined 报错的关键在于：确保运行的是 Hugo ≥0.17 的版本，并启用正确的多语言配置。
✅ 首先验证 Hugo 版本：
hugo version
若输出版本号低于 v0.17.0（例如 v0.16.0），请立即升级：
推荐方式（使用二进制安装）：
访问 Hugo Releases 页面，下载最新 hugo_extended 版本（含 Sass/SCSS 支持，多语言功能亦依赖此构建）。解压后替换旧二进制文件，或将其加入 $PATH。-
替代方式（Go 构建，仅适用于 Go 环境）：
Go语言（Golang）1.26.0下载Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
# 确保已安装 Go（≥1.16） git clone https://github.com/gohugoio/hugo.git cd hugo go install --tags extended .
⚠️ 注意：必须添加 --tags extended 参数，否则生成的二进制不包含 i18n 运行时支持，仍会报错。
✅ 其次，确认站点配置启用多语言：
在 config.toml（或 config.yaml）中，至少定义两种语言并启用 defaultContentLanguageInSubdir = true（可选但推荐）：
# config.toml
defaultContentLanguage = "en"
defaultContentLanguageInSubdir = true
[languages]
[languages.en]
languageName = "English"
weight = 1
[languages.zh]
languageName = "中文"
weight = 2
✅ 最后，在模板中正确调用 i18n 函数：
确保 i18n 调用位于支持多语言的上下文（如页面、站点层级），且翻译键已在 i18n/ 目录下定义：
<!-- layouts/partials/header.html -->
{{ i18n "welcome" }} <!-- 对应 i18n/en.yaml 中的 welcome: "Welcome" -->
并在 i18n/en.yaml 和 i18n/zh.yaml 中提供翻译：
# i18n/en.yaml - id: welcome translation: "Welcome"
# i18n/zh.yaml - id: welcome translation: "欢迎"
? 重要提醒：
- Hugo ≤0.16 不识别 i18n 函数，强制升级是唯一可靠解法；
- 使用 hugo server --disableFastRender 可帮助调试多语言路由问题；
- 所有内容文件需添加 lang 前缀（如 about.en.md / about.zh.md）或通过 translationKey 关联；
- 官方多语言文档持续更新，建议查阅最新版：Hugo Multilingual Documentation。
完成上述步骤后，hugo server 应能正常启动，i18n 函数生效，多语言菜单、URL 路由与内容切换均可按预期工作。
