goland中“未被调用的函数”由golangci-lint的unused linter识别，需配置.golangci.yml启用且版本≥v1.52.0，ide须正确设置路径并勾选「use config file」，否则无法实时标红；它不误报导出函数，但对反射、http路由等运行时调用无感知。
GoLand里“未被调用的函数”靠unused linter识别，不是靠Find Usages
GoLand 自带的 Find Usages（Alt+F7）只能查“被谁用了”，查不到“根本没人用”。真正能揪出未导出函数、无用变量、废弃 import 的，是 unused 这个 linter——它属于 golangci-lint，且默认不启用。
- 如果你只依赖 IDE 的高亮或右键菜单，
unused不会自动触发，那些“写了但从没被调用”的私有函数会一直安静躺在代码里 -
unused能识别：func helper() {}（未导出且无调用）、var _ = someFunc()（显式忽略返回值但函数本身未被其他地方调用）、import "fmt"（整个包只用于_ = fmt.Sprintf，且 fmt 无其他引用） - 它不会误报导出函数（如
func ServeHTTP()），因为可能被反射或插件机制调用——这种需人工判断，unused保持沉默
必须配.golangci.yml并显式启用unused
光装 golangci-lint 不行，不配配置文件等于白装。IDE 插件不标红、命令行 golangci-lint run 没输出，八成是配置没生效。
- 配置文件名必须是
.golangci.yml（不是.golangci.yaml或golangci.yml），且必须放在go.mod同级目录 - 内容至少包含：
linters-settings: unused: check-exported: false linters: enable: - unused - CI 或终端运行时要加
--config=.golangci.yml，否则它直接退回到只跑govet和errcheck的极简模式 - 多 module 项目中，每个 module 目录下都得放一份
.golangci.yml，父目录的配置不继承
在GoLand里让unused实时标红，要检查三处路径
即使配置写对了，IDE 也可能“视而不见”。常见断点不在规则本身，而在路径链上。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 插件设置里必须勾选「Use config file」，且路径填的是
.golangci.yml（不能留空、不能填相对路径如./.golangci.yml） - IDE 启动时的工作目录必须是含
go.mod的根目录；如果从桌面快捷方式启动却没 cd 进项目，它会找不到配置 - 插件调用的
golangci-lint二进制版本要 ≥ v1.52.0；旧版对unused的函数可达性分析不完整，部分未调用函数压根不报 - 验证方法：在文件里写
func dead() {}，然后终端执行golangci-lint run --config=.golangci.yml --no-config .—— 如果终端报了func dead is unused但 IDE 编辑器没红线，就是插件路径或缓存问题
unused报的“未使用”不等于可直接删，要看作用域和初始化时机
它报出来的地方，有些真该删，有些则藏着陷阱。别见红就删，先看上下文。
- init 函数里的调用会被识别，但
init()本身不会被标记为未使用——它是隐式入口，unused放行 - 注册型代码（如
http.HandleFunc("/api", handler)）中传入的handler函数，如果只在这里出现一次，unused仍会报；这是正常现象，因为 HTTP 路由是运行时绑定，静态分析无法确认是否真被请求触发 - 测试文件（
*_test.go）里的私有函数，若只在本测试文件内被调用，unused默认不检查——除非你在.golangci.yml里加了run: tests: true - 反射调用（
reflect.ValueOf(fn).Call(...)）完全逃逸unused检测，这类函数必须靠人工维护注释或文档说明用途
真正难处理的是那种“看起来没被调用，但可能被插件系统、配置驱动或未来扩展点触发”的函数。它们不是 bug，而是设计残留——这时候删不删，得翻文档、问原作者，或者加个 //nolint:unused 注释留痕。
