GoLand 补全混乱的根本原因是默认索引整个 go.mod 构建图（含 indirect 依赖和测试模块），而非仅当前文件 import 的包；可通过配置 Scope 范围和启用 useImportPathsForIndexing 精准控制补全来源。
GoLand 为什么总把 golang.org/x/ 或 testutil 包塞进补全列表
根本原因不是你 import 了它们，而是 GoLand 默认索引整个 go.mod 构建图——包括所有 // indirect 依赖、测试专用模块（如 github.com/stretchr/testify）、甚至被 replace 掉但仍在 go.sum 里的旧版本。它不区分“当前文件用没用”，只认“模块图里有没有”。结果就是敲 json. 时，补全框里冒出 jsonrpc2、jsoniter、jsonschema 等八竿子打不着的包。
用 Scope 精确限定补全来源范围
这是最直接有效的过滤手段，不改配置、不删依赖，只让补全“眼不见为净”：
- 打开 Settings → Appearance & Behavior → Scopes，点击
+新建一个 scope，命名如main-only - Pattern 填：
file:src//||file:cmd//||!file:**/vendor/**||!file:**/testutil/**||!file:**/internal/test/**（按需增删路径） - 回到 Editor → General → Code Completion，关闭
Show suggestions regardless of context - 在
Autopopup code completion下拉菜单中，选中你刚建的main-onlyscope
注意：scope 不影响 go list -m all 输出，但它会真实削减补全候选——实测可减少 60%+ 的干扰项；测试文件（*_test.go）默认不在此 scope 内，所以不会误伤测试依赖。
强制 GoLand 只按 import 路径建索引
关键一步是让 IDE 放弃“整张图都索引”的粗暴做法，转而只看代码里真正 import 的路径：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 在项目根目录下，确保存在
.idea/misc.xml（若无则新建） - 往里面加这段配置：
<project version="4"> <component name="GoProjectSettings"> <option name="useImportPathsForIndexing" value="true"/> </component> </project> - 保存后，必须手动触发 File → Reload project，否则配置不生效
这个设置会让 GoLand 把 import "github.com/gin-gonic/gin" 当作唯一索引入口，而不是把 gin 所有间接依赖（比如 golang.org/x/net）也拖进来。它比关掉 Add unambiguous imports on the fly 更底层、更彻底。
别信 go mod tidy 后补全就干净了
go mod tidy 只改 go.mod 和 go.sum，它不碰 GoLand 已缓存的索引。常见陷阱包括：
- 运行
go mod tidy后没点 Reload project，IDE 还在用旧索引，补全照样乱 - 某个包被
replace到本地路径，即使已从go.mod删除，GoLand 仍会索引那个本地目录下的所有.go文件 - 测试文件里的
import也会进补全——除非你用//go:build !test或显式排除测试路径
真正要确认是否过滤成功，不是看 go mod graph，而是打开任意 .go 文件，敲 http. 后观察补全列表是否只剩标准库和你明确 import 的包。如果还有 httprouter、httpexpect，说明 scope 或索引配置没生效。
