GoLand代码提示出现无关包的根本原因是其默认索引整个go.mod构建图（含indirect依赖）。解决方法包括：关闭自动导入、禁用短名导入、在.misc.xml中启用useImportPathsForIndexing、通过Scope限制补全范围，并配合go mod tidy后手动Reload project。

GoLand 的代码提示为什么总冒出无关包

根本原因是 GoLand 默认把整个 go.mod 里声明的所有模块（包括 // indirect 的）都纳入代码补全索引，哪怕你从没 import 过它们。它不区分“声明了”和“用到了”，只认构建图里的节点。

关闭间接依赖的自动补全

GoLand 本身不提供开关直接禁用间接依赖提示，但能通过调整索引范围规避：

• 进入 Settings → Editor → General → Auto Import，取消勾选 Add unambiguous imports on the fly —— 这能防止它偷偷帮你 import 不相关的包
• 在 Settings → Languages & Frameworks → Go → Imports 中，把 Use short names for imported packages 关掉，避免因别名冲突导致补全混乱
• 最关键一步：在项目根目录下新建 .idea/misc.xml（如果不存在），添加以下内容强制限制索引范围：

  <project version="4">
    <component name="GoProjectSettings">
      <option name="useImportPathsForIndexing" value="true"/>
    </component>
  </project>

  这个设置会让 GoLand 只基于实际 import 路径建索引，而不是整张 go mod graph

用 scope 精确控制补全来源

如果你只希望补全来自当前 module 的包（比如排除 golang.org/x/... 或测试专用库），就得靠作用域：

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 打开 Settings → Appearance & Behavior → Scopes，点击 + 新建一个 scope
• 命名如 main-only，模式填：file:src//||file:cmd//||!file:**/vendor/**||!file:**/testutil/**
• 然后在 Editor → General → Code Completion 中，把 Show suggestions regardless of context 关掉，并确保 Autopopup code completion 的触发范围设为该 scope
• 注意：scope 不影响 go list -m all 输出，但它会真实削减补全候选列表——实测可减少 60%+ 的干扰项

别信 go mod tidy 后补全就干净了

go mod tidy 确实能删掉未 import 的模块，但它只改 go.mod，不影响 GoLand 已缓存的索引。常见陷阱：

• 运行 go mod tidy 后必须手动触发 File → Reload project，否则 GoLand 还在用旧索引
• 如果某个包被 replace 到本地路径，即使已删，GoLand 仍会索引那个本地目录下的所有 .go 文件
• 测试文件（*_test.go）里的 import 也会进补全——除非你用 //go:build !test 显式隔离，否则无法从补全中剔除

真正干净的补全，永远依赖 import 语句 + 构建标签 + IDE 作用域三者对齐，缺一不可。