Go项目中精准清理未用符号需启用golangci-lint的unused linter，它默认只报未被引用的导出符号；启用check-exported: false可检查私有符号，但需排除测试、init函数等误报场景，并通过exclude-rules或//nolint手动干预。
你想在 Go 项目中精准识别并清理掉那些定义了却从未被调用的变量、函数、类型或导入，避免代码库持续膨胀和维护负担加重。
确认 unused linter 已启用
打开项目根目录下的 .golangci.yml 文件，检查 linters.enable 列表中是否包含 unused：
如果未启用，直接在 enable 列表末尾添加 - unused；若已存在但被注释掉，取消注释即可。
【注意：enable 和 disable 不可共存】 若配置中同时出现 disable 和 enable，golangci-lint 将报错退出，必须删掉其中一种策略。
立即学习“go语言免费学习笔记（深入）”；
跳过 false positive 的典型场景
unused 检查器对以下三类情况容易误报，需针对性排除：
方法一：跳过整个测试文件夹
在 run.skip-dirs 中加入 - testdata 和 - internal/testutil（若你有自定义测试工具包）。
方法二：忽略特定导出符号的未使用警告
在 issues.exclude-rules 下添加正则匹配规则，例如屏蔽所有以 TestHelper 开头的未使用函数：
- linters: [unused] path: ".*_test\.go$" text: "func TestHelper"
方法三：用 //nolint 注释临时绕过单行检测
在疑似误报的变量声明后加 //nolint:unused，如：var _ = fmt.Print //nolint:unused。
区分 exported 与 unexported 符号的检查行为
第一步：理解默认行为
unused 默认只报告 未被任何其他包引用的 exported 符号（即首字母大写的变量/函数/类型），而不会检查 unexported 符号（小写字母开头）——因为它们本就只能在当前包内使用，是否“被用”完全由本包决定。
第二步：启用 unexported 检查（可选）
若需检查包内未使用的私有符号，在 linters-settings.unused 下添加：check-exported: false。此时它将转为检查所有符号，包括小写名称。
第三步：注意副作用
启用后，func init()、匿名函数赋值给变量、空接口断言等常见模式可能被误判为未使用，需配合 exclude-rules 或 //nolint 手动过滤。
验证 unused 是否生效
执行 golangci-lint run --out-format=tab，观察输出中是否含 unused 字样及对应文件行号。
手动制造一个未使用导出函数，例如在 main.go 顶部加：func UnusedExported() {}，再运行检查命令，应立即看到告警。
若无输出，检查 GOPATH/bin 是否在 PATH 中、.golangci.yml 是否位于正确路径、Go module 是否已启用（go env GO111MODULE 应为 on）。
