goland需手动将.tmpl关联到go template文件类型并确保gopls正确索引：在settings→editor→file types中为go template添加*.tmpl；确认go.mod存在且go111module=on；通过go list验证模板路径可见性，否则补全和跳转无效。
GoLand 默认不把 .tmpl 当作 Go 模板处理，它被识别为纯文本——所以没高亮、没补全、没结构校验。这不是 bug，是文件类型映射没配对。
让 .tmpl 文件被识别为 Go template
GoLand 本身不内置 .tmpl 到 Go 模板的绑定，它只认 .gohtml 和部分硬编码后缀。你需要手动把后缀关联到 Go template 文件类型：
- 打开
Settings → Editor → File Types - 在右侧列表中找到
Go template（不是 HTML 或 Text） - 在
Registered Patterns区域点击+，输入*.tmpl - 确认没有其他规则（比如
Text类型）也匹配*.tmpl，否则会优先命中低优先级类型
改完后，任意已打开的 .tmpl 文件需手动 Reload from Disk 或关闭重开，高亮才生效。
补全和语法检查仍不工作？检查 gopls 是否接管了模板
即使后缀绑对了，GoLand 的 Go template 支持依赖 gopls 提供语义信息。如果补全空白、跳转失败、{{ .Field }} 不提示字段，大概率是 gopls 没加载模板上下文：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确保项目根目录有
go.mod，且GO111MODULE=on（go env GO111MODULE应输出on） - 检查
gopls日志：按Ctrl+Shift+A输入Toggle Verbose Logging，重启 IDE，看是否报no template files found或failed to parse template - 临时验证：在
.tmpl里写一个明显错误，如{{ .Unknown.Field }}，保存后观察是否出现波浪线提示——没提示说明gopls根本没扫描该文件
若确认 gopls 未加载，尝试在项目根目录执行 go list -f '{{.Dir}}' ./...，看是否能列出含 .tmpl 的子目录；不能则可能是模块路径或 go.work 配置隔离了模板目录。
高亮颜色太淡或和 HTML 混淆？别动通用颜色方案
GoLand 对 Go template 的高亮样式由 Go template 专属颜色项控制，不是靠 HTML 或 Text 颜色继承：
- 进入
Settings → Editor → Color Scheme → Go template - 展开后重点调
Template action（对应{{ ... }}）、Template variable（对应.Field）、Template comment（对应{{/* */}}） - 不要去改
General → Identifier或HTML → Tag，那会影响所有语言，且对.tmpl无效 - 如果
Go template项是灰色不可编辑，说明当前方案是只读的（如Darcula），先点右上角Duplicate再修改
改完颜色后，需关闭再重开 .tmpl 文件才能看到变化——缓存不会自动刷新。
真正卡住的点往往不在配置本身，而在于 gopls 是否把 .tmpl 当作“属于这个模块的模板”来索引。哪怕后缀、颜色、文件类型全对，只要 gopls 没把它纳入分析范围，补全和跳转就永远是空的。建议先用 go list 验证路径可见性，再调 IDE 设置。
