最可靠的选项是Save to dictionary且必须选Project dictionary;它将词写入.idea/dictionaries/yourname.xml并支持Git共享,选错词典级别或编码/路径/格式错误会导致失效。

Alt+Enter 调出的拼写修复选项里,哪个最可靠?
光标停在被标黄的词(如 ID、URL、gRPC)上按 Alt+Enter,弹出菜单中唯一真正有效的选项是:Save to dictionary。其他如 “Ignore once” 或 “Add to custom dictionary”(旧版 UI 文案)本质相同,但关键在于选对词典级别。
必须选 Project dictionary,而不是默认的 Application dictionary——否则换项目或重装 GoLand 就失效。这个操作会把词写入 .idea/dictionaries/yourname.xml,可直接 Git 提交,团队共享。
- 选错词典类型会导致:同一词在 A 项目不报错,B 项目继续标黄
- 大小写必须完全一致:
ID加了,Id和id仍会被标 - 加完后不重启 GoLand,部分文件可能缓存旧状态,建议重启确认
为什么点了 Alt+Enter 没反应?检查这三处
不是所有标黄词都支持 Alt+Enter 快速保存——它只对「拼写检查模块识别为错误但未收录」的词生效。如果没弹出菜单,大概率是以下原因:
- 拼写检查根本没启用:
Settings → Editor → Inspections → Proofreading → Typo未勾选 - 作用域被限制:展开
Typo后,Treat code identifiers as typos没勾选(变量/函数名就不会检查) - 当前文件类型被排除:Scope 设置成了
Only in comments and strings,跳过代码标识符
注意:Alt+Enter 对拼写警告的响应,和对语法错误(如 userNmae 变量名拼错)或 linter 报错(如 staticcheck)的响应是两套机制,别混淆。
Save to dictionary 后还是标黄?可能是编码或路径问题
词典文件加载失败时,GoLand 不报错也不提示,只会静默忽略。常见故障点:
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 词典文件用了非 UTF-8 无 BOM 编码(尤其 Windows 上用记事本另存容易带 BOM)
- 路径不对:
.idea/dictionaries/是唯一被识别的目录,放错位置(比如根目录下go-terms.dic)不会生效 - XML 格式错误:自定义
.xml词典里漏了<?xml version="1.0" encoding="UTF-8"?>声明,或<w></w>标签未闭合
最简单的验证方式:删掉刚加的词,重启 GoLand,再手动加一次——如果这次能立刻生效,说明之前是缓存或路径问题。
别指望 Alt+Enter 修驼峰拆分问题
userID 被标黄,不是因为 userID 拼错了,而是拼写检查把它拆成 user 和 ID,再认为 ID 不在词典里。此时 Alt+Enter → Save to dictionary 加的是 ID,不是 userID。
这意味着:
- 你得分别加
ID、HTTP、JSON、TTL等所有大写缩写,不能偷懒加userID - 加了
ID后,apiID、orderID也会自动通过,因为拆分逻辑不变 - 如果项目大量用
ClientId这种混合写法,还得额外加ClientId(驼峰首字母大写形式)
真正省事的做法,是关掉 Treat code identifiers as typos,只保留对注释和字符串的拼写检查——毕竟变量名合法性该由编译器和 linter 管,不该靠拼写词典兜底。

















