goland 中已废弃函数的删除线和置灰效果由 //go:deprecated 指令与 gopls 语义分析共同触发，非靠 color scheme 中 comments 或 identifier 颜色设置实现；必须满足指令紧贴导出函数、gopls 就绪且模块有效三条件。
GoLand 里已废弃函数的删除线和置灰效果，不是靠改“颜色”实现的，而是由 //go:deprecated 指令 + gopls 语义分析共同触发的视觉降级；单纯调配色方案里的 Comments 或 Identifier 颜色完全无效。
为什么改了 Comments 或 Identifier 颜色没用
很多人在 Settings → Editor → Color Scheme → Go 里反复调整 Comments、Identifier 甚至 Deprecated symbol（该选项实际并不存在），结果函数名依然不加删除线、也不变灰。这是因为：
- GoLand 本身不内置“已弃用符号”的独立 token 类型，
Deprecated symbol这个条目在当前所有官方配色方案中都未定义，点开就是空的 - 删除线（strikethrough）和低饱和度（grayed-out）是 gopls 根据
//go:deprecated指令动态注入的渲染指令，不是静态配色项 - 如果你只写了
// Deprecated: use NewClient instead注释，gopls 默认不识别——它需要//go:deprecated才能激活前端降级
必须同时满足的三个条件才能看到删除线
缺一不可，否则 IDE 就当它是普通函数：
-
//go:deprecated必须紧贴导出标识符声明上方，且中间不能有空行（例如函数前一行是注释可以，但隔一行就不行） - 函数必须是导出的（首字母大写），非导出函数即使加了指令也不会被标记
- gopls 必须就绪：右下角状态栏显示
gopls (v0.15.0+)，且项目根目录存在go.mod；若显示loading，按Ctrl+Shift+P→ 输入Go: Restart Language Server强制重启
示例正确写法：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
//go:deprecated use NewClient instead
func OldClient() *Client { ... }
删除线颜色和灰度值无法直接配置，但可间接影响
你不能在 Color Scheme 里找到“Deprecated text”去调色，但以下两项会影响最终呈现效果：
-
Identifier的 Foreground：删除线下的文字仍走 identifier 渲染，如果它本身设为#888（浅灰），那即使加了删除线，整体也显得更“旧”；推荐保持默认或设为稍暗的灰（如#666）增强对比 -
General → Editor → Caret row highlight：如果当前行高亮背景太亮（比如#333），会削弱删除线的视觉权重；建议设为比主背景略深的值（如#252525），让删除线更突出 - 别碰
Strikethrough color：这个字段在 GoLand 当前版本中未启用，修改无效；删除线颜色始终继承文字 foreground，只是叠加了划线样式
常见失效场景和验证步骤
如果写了 //go:deprecated 却没反应，按顺序排查：
- 检查是否误写成
//go:deprecate或//go deprecated（少冒号、多空格都不行） - 确认函数在
go.mod声明的 module 内；跨 module 引用时，只有调用方能看到删除线，定义方不会自动高亮自己 - 临时禁用 Rainbow Brackets、Indent Rainbow 等插件，它们偶尔会劫持文本渲染层，覆盖删除线绘制
- 在函数名上悬停，看是否出现
Deprecated: use NewClient instead提示；有提示但无删除线 → 渲染层被干扰；无提示 → 指令未生效或 gopls 未加载
真正起作用的是指令与语言服务器的协作机制，不是颜色配置。调错地方，再调十次也白搭。
