goland中“未使用代码块”指被if false{}、构建标签或编译指令注释屏蔽的不可达代码，ide默认不灰显也不折叠，需手动启用代码折叠或配置build tags排除，但视觉处理不能替代go vet或staticcheck等工具验证。
GoLand 里“未使用代码块”指的是什么
GoLand 不会像 Java 或 Kotlin 那样标记“未使用的局部变量”或“未调用的私有方法”为灰色——Go 语言本身不支持运行时反射式符号引用分析，且编译器对未使用标识符直接报错（xxx declared but not used），所以所谓“隐藏未使用的代码块”，实际是指：被 //go:noinline、//go:linkname 等编译指令注释掉的代码，或被 if false { ... }、if debug { ... } 包裹但当前条件下永不执行的块。这类代码 GoLand 默认不会折叠，也不会灰显，但你可以手动控制其可见性。
用代码折叠（Code Folding）临时收起条件块
GoLand 支持基于语法结构的自动折叠，但对 if false 或 if buildTag == "dev" 这类运行期不可达分支，默认不折叠。你需要主动启用对应规则：
- 打开 Settings → Editor → General → Code Folding
- 勾选
Fold code blocks in comments（对// region有效）和Fold if/else branches - 对
if false { ... }块，将光标放在if行，按Ctrl + .（Windows/Linux）或Cmd + .（macOS），选择Fold selection—— 它会把整个块变成一行if false {...} - 注意：折叠后，
if false块内如果有语法错误，GoLand 不再实时校验，可能掩盖问题
用构建标签（build tags）配合文件级排除
比折叠更彻底的方式是让 GoLand “看不见”某些文件。GoLand 尊重 //go:build 和 // +build 注释，若某文件顶部声明了不匹配当前配置的构建标签，它会被 IDE 标记为“excluded”，不参与索引、跳转和高亮：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 例如，在
debug_only.go开头写：//go:build debug<br>package main
- 然后在 Settings → Go → Build Tags and Vendoring 中设置当前生效的 tag（如填
debug） - 若你清空 build tags 或设为
prod，该文件立刻变灰、不出现在 Ctrl+Click 跳转结果中，也不触发 lint - ⚠️ 注意：
//go:build和// +build不能共存；GoLand 2023.3+ 优先识别//go:build，旧版本需用// +build
别依赖“灰色显示”来判断是否未使用
GoLand 对 Go 的“未使用”提示非常有限：它只能检测到 var x int 后完全没引用的变量，并标灰；但对函数参数、结构体字段、导出标识符（哪怕整个项目都没调用），它一律不灰显——因为 Go 编译器允许它们存在（比如供外部包使用）。真正可靠的判断方式只有：
- 运行
go vet -v ./...查unusedwrite、fieldalignment类警告 - 用
staticcheck（推荐集成进 GoLand 的 External Tools）跑staticcheck -checks=U1000 ./...检测未导出但未使用的标识符 - 删除疑似无用代码后，执行
go test ./...确保所有测试仍通过
折叠或排除只是视觉管理手段，不是代码健康度的代理指标。真正要删的代码，得靠工具链验证，而不是看颜色。
