Go编译器将未使用导入视为错误而非警告，因其会触发init函数、影响链接体积并改变程序行为，旨在防止隐性依赖和构建不确定性。
为什么 Go 编译器会严格拒绝 unused import
Go 把未使用导入视为编译错误，不是警告——因为 import 不只是“声明要用”，它实际触发包初始化（init() 函数执行）、影响链接体积、甚至改变程序行为（比如某些包注册全局 handler）。编译器不让你侥幸绕过，是防止隐性依赖和构建不确定性。
常见错误现象：./main.go:3:2: imported and not used: "fmt" 或更隐蔽的：只用了 fmt.Println 却删了调用，但 import "fmt" 还留着。
- 别指望加
_前缀能“静默导入”——那适用于需要触发init()但不用导出符号的场景（如import _ "net/http/pprof"），不是用来糊弄编译器的 - IDE 自动补全或重构残留的 import 最常引发这个问题，尤其在删掉调试代码后忘记清理
- Go Modules 下，
go mod tidy不会帮你删掉源码里还存在的未使用 import，它只管go.mod和go.sum
怎么快速定位并删掉真正的 unused import
手动扫 import 列表容易漏，尤其有十几个包时。推荐用 goimports 或 gofmt -w 配合编辑器自动修复，但要注意它们的行为差异：
-
goimports -w main.go：重排 import 分组 + 删除未使用项 + 补全缺失项（需已安装：go install golang.org/x/tools/cmd/goimports@latest） -
gofmt -w main.go：只格式化，不删 import；Go 1.22+ 的gofmt仍不处理未使用问题 - VS Code 中启用
"golang.formatTool": "goimports"后，保存即生效；JetBrains 系列需单独装插件并配置 - CI/CD 流水线里建议加一步检查：
go list -f '{{if len .Imports}}{{.ImportPath}}: {{.Imports}}{{end}}' ./... | grep -q 'unused' && exit 1 || true（不推荐，太糙）；更稳的是用staticcheck：staticcheck -checks 'SA1019' ./...（它能报出未使用 import）
哪些情况看似“没用”，其实不能删
不是所有标灰的 import 都真能删。以下情况保留是必须的：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 包只用于其
init()函数，比如注册驱动：import _ "github.com/lib/pq"—— 删了会导致sql.Open("postgres", ...)panic - 类型别名或嵌入结构体间接依赖某个包的类型，但源码里没直接写包名：
type DB struct { *sql.DB }仍需import "database/sql"，即使没显式调用sql.开头的函数 - Go 1.21+ 引入的 embed 包：
import "embed"即使没写embed.FS类型，只要用了//go:embed指令就必须保留 - 测试文件（
*_test.go）里导入了生产代码不用的包（如"testing"、"github.com/stretchr/testify/assert"），这是合法且必需的，不会被主程序编译器检查到
vscode 或 goland 里老是误报 unused import 怎么办
这通常是 LSP（gopls）缓存或模块状态不同步导致的假阳性，不是代码问题：
- 先运行
go mod tidy，确保go.mod和实际 import 一致 - 重启
gopls：VS Code 里按Ctrl+Shift+P→ 输入 “Go: Restart Language Server”；Goland 在File → Manage IDE Settings → Tools → gopls里点 restart - 检查工作区是否打开了错误的根目录——比如项目里有多个
go.mod，但编辑器加载的是父级空模块，导致子模块 import 被识别为“外部未解析” - 禁用不必要的 linter：如果同时开了
revive或megacheck，它们可能比编译器更激进地报 unused，关掉即可，以go build结果为准
真正麻烦的永远不是“删哪一行”，而是搞清这个 import 到底有没有副作用——看它有没有 init()，有没有被 embed 或 go:generate 引用，有没有被测试文件独占。编译器卡在这里，其实是逼你把依赖关系想清楚。
