goland代码提示冗余的根源是默认启用“index entire gopath”和“index modules outside of project”，关闭这两项后补全仅基于当前项目go.mod显式依赖和标准库，可消除90%干扰。
为什么代码提示总弹出你不想要的包
GoLand 默认把所有已下载、可解析的包都纳入代码补全候选集，哪怕你只 import 了 fmt，github.com/stretchr/testify/assert 或 golang.org/x/net/http2 也可能出现在 assert. 或 http2. 的补全列表里——只要这些包在 go.mod 中声明过，或被其他模块间接引入，IDE 就认为“它存在”，就会参与提示。
关闭全局包索引扫描（最有效）
根本原因是 GoLand 默认启用 “Index entire GOPATH” 和 “Index modules outside of project” 两类索引。它们让 IDE 把本地 $GOPATH/pkg/mod 下所有缓存包、甚至其他项目的 vendor 目录都拉进来补全。
- 按
Ctrl+Alt+S打开 Settings - 进入
Go | GOPATH，取消勾选Index entire GOPATH - 进入
Go | Modules，取消勾选Index modules outside of project - 重启 GoLand 或点击右上角
File | Reload project
做完这一步，补全将只基于当前项目 go.mod 显式 require 的依赖，以及标准库，大幅减少干扰项。
用 go.mod exclude 不能屏蔽补全
exclude 只影响版本选择和构建时的 module graph，**不阻止 IDE 索引该包**。比如你在 go.mod 里写：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
exclude github.com/stretchr/testify v1.8.0
GoLand 依然会扫描这个包的符号并放进补全列表——因为 exclude 不等于 “删掉” 或 “不可见”。真正起效的是物理隔离 + 构建标签，但那针对的是编译行为，不是补全。
手动排除特定包路径（精准控制）
如果你只想屏蔽某个第三方包（比如 github.com/xxx/legacy-utils）的所有补全，又不想动全局索引设置，可以用 GoLand 的「Excluded Paths」功能：
- 右键点击项目根目录 →
Mark Directory as → Excluded - 但这不适用于远程包；正确做法是：进入
Settings | Directories - 点击
+ Add Content Root→ 添加$GOPATH/pkg/mod/cache/download/github.com/xxx/legacy-utils对应的实际路径（可通过go list -f '{{.Dir}}' github.com/xxx/legacy-utils查） - 选中该路径 → 点击右侧
Exclude按钮
注意：路径必须精确到模块缓存目录的顶层文件夹，且每次 go mod download 后可能需要重新 Exclude —— 这是个运维成本较高的方案，适合临时压制某个顽固包。
补全干扰本质是索引范围问题，不是语法错误。关掉那两个 “Index…” 选项后，90% 的冗余提示就消失了；剩下的个别包，要么从 go.mod 里彻底删掉 require，要么接受它偶尔冒出来——毕竟 IDE 不会为每个包单独开关补全开关。
