go mod tidy 不会删除源码中多余的 import 语句，仅同步更新 go.mod 和 go.sum；残留 import 需手动删除或用 GoLand 的 Ctrl+Alt+O（Cmd+Option+O）优化，配合 Invalidate Caches 修复标红。
go mod tidy 不能自动删掉 import 语句
很多人以为 go mod tidy 会同步清理代码里多余的 import 行，其实不会。它只管 go.mod 和 go.sum：移除未被 require 的模块、补全缺失的依赖、校验哈希。但源码中残留的 import（比如删了调用却忘了删 import）仍会留在文件里，GoLand 就可能因找不到对应包而标红。
解决办法是手动删或借助格式化工具：
- 选中整段 import 块 → 按
Ctrl + Alt + O（Windows/Linux）或Cmd + Option + O（macOS），GoLand 会自动删掉未使用的 import - 启用「Save Actions」插件，勾选 “Optimize imports on save”，保存时自动清理
- 注意：如果 import 被注释掉但没删，
go mod tidy不感知，GoLand 也可能误判为“引用存在”，导致标红不消失
GoLand 的符号索引缓存比 mod 缓存更常导致标红
即使 go mod tidy 执行成功、go build 也能通过，GoLand 仍可能把合法 import 标红。这基本是它的符号索引没跟上实际代码结构变化，比如刚重命名包、移动文件、或项目首次打开未完成索引。
必须做的是：
- 点击
File → Invalidate Caches and Restart…→ 选Invalidate and Restart - 重启后等左下角 “Indexing” 消失，再检查标红是否恢复
- 不要只清
go clean -modcache，那只是清下载的模块文件，不影响 IDE 内部符号关系 - 如果项目用了
replace或本地路径依赖，索引失败概率更高，此时必须 invalidate 缓存
为什么 go clean -modcache 后还要 go mod download
go clean -modcache 会删掉 $GOPATH/pkg/mod 下所有已缓存模块，但不会重新拉取——它只是清空，不是重装。所以清理后立刻打开 GoLand，很可能看到一堆 import 标红，因为 IDE 找不到本地模块文件。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
正确顺序是：
- 执行
go clean -modcache - 再执行
go mod download，强制把go.mod里所有 require 的模块下载到本地缓存 - 最后运行
go mod tidy，确保版本一致、go.sum更新 - 做完这三步再 invalidate caches，否则 GoLand 索引时会反复失败
replace 本地依赖导致标红时的典型陷阱
用 replace 指向本地路径（如 replace github.com/user/lib => ../lib）时，GoLand 容易标红，常见原因有：
-
../lib目录下没有go.mod文件 → 运行go mod init github.com/user/lib补上 - 路径写成绝对路径（如
C:\dev\lib）或file://协议 → GoLand 可能解析失败，且无法协作 - 没运行
go mod tidy→replace不生效，IDE 仍按远程路径找包 - GoLand 设置里 GOPROXY 被设为
direct或私有代理，绕过了本地替换逻辑 → 检查Settings → Go → Modules → Proxy是否设为 “Use GOPROXY environment variable”
本地开发阶段用 replace 是合理的，但别指望 IDE 不 reload 就自动识别；每次改完 go.mod，都要搭配 go mod tidy + invalidate caches 才算闭环。
