goland 中可通过修改文件类型配置让导航不跳进 _test.go 文件：将 _test.go 从“go test”类型移除，并添加到“go”类型中，使其仅保留语法高亮和测试运行能力，不再干扰跳转、查找引用等导航操作。
GoLand 中如何让导航不跳进 *_test.go 文件
GoLand 默认把 _test.go 文件当作普通 Go 包参与代码导航（比如 Ctrl+Click 跳转、Find Usages、Go to Declaration），这会导致你点进一个函数后，意外落到测试文件里——尤其当测试文件和业务文件同名（如 user.go 和 user_test.go）时特别容易混淆。
根本原因是 GoLand 没区分“源码”和“测试源码”的语义，默认全索引。解决方法不是删文件或改名，而是通过 IDE 的文件类型识别机制做排除：
- 打开 Settings / Preferences → Editor → File Types
- 在右侧 “Recognized File Types” 列表中，找到并选中 Go Test
- 滚动到底部，在 “Registered Patterns” 区域，确认
*_test.go已列在其中（这是默认行为） - 点击右侧的 - 按钮，把它从 “Go Test” 类型中移除
- 再选中 Go 类型，在其 “Registered Patterns” 里手动添加
*_test.go
这样做的效果是：GoLand 仍能语法高亮、运行测试，但所有导航操作（跳转定义、查找引用、结构视图）都按“普通 Go 代码”处理 _test.go，而不再将其视为独立的“测试上下文”。它不会出现在 “Go Test” 的专用视图里，也不会干扰主逻辑的导航路径。
为什么不能只靠 go:build 标签屏蔽导航
//go:build !test 或 //go:build unit 这类构建标签，只影响编译期是否包含该文件，对 GoLand 的索引和导航**完全无效**。IDE 不执行构建，它依赖 AST 解析和文件系统扫描。即使你加了构建标签，只要文件存在且匹配 *_test.go 模式，GoLand 就会把它纳入索引，并在跳转时优先展示（因为测试文件常含同名函数实现）。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
常见误操作包括：
- 以为在
go.mod里exclude了某个测试依赖，就能让 IDE 忽略对应测试文件 —— 不成立 - 把测试逻辑写在
main_test.go里，指望 IDE 自动忽略 —— 它照样索引 - 仅关闭 “Include test sources” 覆盖率选项 —— 这只影响覆盖率统计，不影响导航
补救：快速过滤掉测试文件的 Find Usages 结果
即便做了上述设置，偶尔仍可能在 “Find Usages” 里看到一堆来自 _test.go 的结果。这时不用重跑索引，直接用过滤：
- 执行
Find Usages（Alt+F7）后，在弹出的结果窗口右上角，点漏斗图标 Filter Settings - 勾选 Exclude files matching pattern
- 填入
*_test.go - 点 OK，结果列表立刻剔除所有测试文件引用
这个过滤是临时的，每次调用都需手动设一次。如果想持久化，可在 Settings → Editor → Find → Scope for Find Usages 里新建一个自定义 scope，排除 **/*_test.go 路径。
注意：HTTP handler 测试里的路由注册仍会被导航捕获
如果你在 router_test.go 里写了 r.GET("/user", handler) 这类注册代码，GoLand 会把 handler 当作真实引用跳转过去——哪怕这个 handler 只在测试中被调用。这不是 bug，是 IDE 对“符号引用”的忠实还原。要避免这种干扰，唯一可靠的方式是：把测试用的路由注册逻辑，拆到带 //go:build unit 的单独文件里，并确保该文件**不被任何非测试构建目标匹配**（比如不在 main.go 的 import 链中）。否则，导航依然会穿透进去。
