goland 不检测未被引用的未导出常量，因其编译期字面量特性、反射/生成代码等间接引用难覆盖，且 go/types 引擎未启用 const 可达性分析；推荐用 find usages 加全局搜索验证，删前须 grep 排查硬编码与契约用途。

GoLand 本身不提供“未被引用的常量”专用检测，因为 Go 编译器对未导出常量（const）的可达性分析极弱，且 GoLand 的语义分析默认不标记“定义但未使用”的私有常量为问题——它只对变量、函数、类型等做较完整的未使用检测。

为什么 GoLand 不标出未使用的 const

GoLand 的“未使用符号”检查（如 Unused symbol）主要覆盖：var、func、type 和导出的标识符。而未导出的 const（比如 const maxRetries = 3）即使在本包内完全没被读取，也不会触发警告。原因有三：

• Go 常量是编译期求值的字面量别名，不占运行时内存，工具链普遍认为“删不删影响极小”
• 常量可能被字符串反射（fmt.Sprintf("%s", "maxRetries")）、日志硬编码或生成代码间接引用，静态分析难覆盖
• GoLand 的底层分析引擎（基于 go/types）对 const 的引用追踪未启用全量可达性传播

手动查未引用常量的可靠方法：Find Usages + 全局搜索

这是目前最可控、零误报的方式，适用于想清理技术债或审计包内冗余定义的场景：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 在编辑器中右键点击该 const 名称 → 选择 Find Usages（或按 Alt F7）
• 若结果为空（显示 “No usages found”），基本可判定未被直接引用
• 再补一招：按 Ctrl Shift F 打开全局搜索，输入该常量名，勾选 Match whole words only 和 Case sensitive，排除注释（取消勾选 “In comments”）
• 特别注意检查是否出现在 go:generate 注释、JSON/YAML 配置字符串、或 //go:build 标签里——这些地方不会被 Find Usages 捕获

用 deadcode 工具辅助，但需注意局限

deadcode 主要针对函数，但它能间接暴露部分常量问题：

• 如果一个未导出常量只被某个未调用的私有函数使用，而该函数又被 deadcode 报出，则这个常量大概率也是冗余的
• 运行 deadcode ./... 后，对报告出的每个 unused func，顺手检查其函数体内是否引用了可疑常量
• 不推荐依赖 go vet -unused：Go 官方 vet 的 unused 检查已废弃，且从不检查 const

真正危险的“伪未使用”常量：删前必验

看似没被引用，但删掉会引发运行时故障：

• const 被用于包级变量初始化：var cfg = Config{Timeout: defaultTimeout}
• 被 unsafe.Sizeof、unsafe.Offsetof 或 cgo 中直接取地址引用
• 名字被硬编码进错误消息或 Prometheus label（如 metrics.WithLabelValues("defaultTimeout")）
• 在测试文件中被 testify/assert 等断言库的参数名字符串隐式引用（极少见，但存在）

这类常量往往在 Find Usages 里“查无此人”，却实际承担契约职责。删之前，至少 grep 一遍整个模块的 .go 和 .test 文件，确认没有字符串匹配。