语义高亮没生效需先确认gopls版本≥v0.15.0且项目根目录存在go.mod并被识别为Go Module；再勾选Settings→Editor→Color Scheme→Go中的Show semantic highlighting开关，并分别设置Local variable、Parameter等角色项的前景色。
语义高亮没生效？先确认 gopls 和 go.mod 两个硬条件
语义高亮（Semantic highlighting）不是纯配色开关，它依赖 gopls 提供的类型信息。如果变量名始终是统一灰色或没变化，大概率卡在这两步：
• gopls 版本太低或未启动：终端执行 gopls version，输出必须含 v0.15.0+；旧版不支持参数/变量级语义着色
• 项目没识别为 Go Module：根目录必须有 go.mod，且右下角状态栏显示 “Go Module” 字样；没有它，gopls 不解析上下文，语义高亮静默关闭
• 状态栏显示 gopls: loading？按 Ctrl+Shift+P → 输入 Go: Restart Language Server 强制重启，比重启 IDE 更快见效
Settings 里真正起作用的开关在哪
很多人在 Editor → Color Scheme → Go 里调了半天颜色却没反应，是因为漏了顶层开关：
• 进入 Settings → Editor → Color Scheme → Go
• 右上角必须勾选 Show semantic highlighting（注意不是 “Enable semantic highlighting”，那是旧版路径）
• 这个开关关着时，所有语义级样式（包括变量分色、泛型高亮、参数提示）全部失效，调什么都没用
• 如果你用了自定义配色方案（比如复制了 Darcula），请确保在该方案下而非 Defaultscheme 里开启此选项
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
让每个变量颜色不同，关键不是“类型”，而是“作用域角色”
GoLand 的语义着色逻辑不是按 string 或 MyStruct 类型统一分色，而是按变量在代码中的语义角色区分：
• Local variable：函数内声明的变量（如 err, data）
• Parameter：函数参数（如 func foo(name string) 中的 name）
• Field access：结构体字段访问（如 user.Name 中的 Name）
• Struct field：结构体定义里的字段名（如 type User struct { Name string } 中的 Name）
• 这些项在 Color Scheme → Go 左侧列表中单独存在，需逐个点开，勾选 Foreground 并设不同颜色
• 别碰 Custom type 或 Built-in type——它们只影响类型名（如 string、User）本身，不影响变量名
改完颜色没立刻看到效果？刷新和验证技巧
语义着色有时延迟渲染，尤其在大型文件或刚启用后：
• 切换到另一个文件再切回来，强制重绘
• 按 Ctrl+Shift+F7 在当前文件触发一次搜索高亮，会连带刷新整行 gutter 和语义标记
• 检查是否被插件干扰：临时禁用 Rainbow Brackets、Indent Rainbow 等修改 gutter 渲染的插件
• 如果只对部分变量生效（比如参数有色、局部变量没色），说明 Local variable 项没勾选或颜色值被设成了透明/背景色
