goland无法为单个包下的文件单独设排除规则，仅支持路径排除或文件名后缀+构建约束两种方式；_test.go是官方特例，其他如gen.go需显式加//go:build ignore并配合-tags=ignore才生效。

GoLand 里不能为“包下的文件”单独设排除规则

GoLand 没有提供“仅对某个 package 下的 .go 文件禁用编译/索引/格式化”的配置入口。它不识别“包路径”作为排除维度，只认文件系统路径或文件名模式。所谓“为某包排除”，实际只能落到具体文件或目录上。

真正生效的排除方式只有两种：路径排除 和 文件名后缀 + 构建约束

你在 GoLand 里看到的“排除”行为，本质是 IDE 层面对 Go 工具链的配合，不是独立机制：

• 路径排除（Settings → Directories → Excluded）：该路径下所有文件（包括 .go）不会被索引、不会出现在 go list 结果里、也不会参与 go build —— 因为 IDE 根本不把它们传给 go 命令
• 文件名后缀 + 构建约束（如 server_linux.go + //go:build linux）：GoLand 会读取这些约束，并在非匹配平台下跳过该文件的语法检查和自动补全；但文件仍被索引，且若你手动执行 go build -tags=linux，它仍会被编译

为什么 _test.go 能自动被忽略？这是特例，不是规则

_test.go 文件能被 GoLand（以及 go 工具链）自动识别为测试文件，是因为 Go 官方定义了这一命名约定，且 go test 和 gopls 都硬编码支持它。但 gen.go、mock.go、stub_linux.go 等都不是标准后缀，IDE 不会自动豁免——除非你显式加 //go:build ignore 并配好 -tags=ignore。

GoLand 2026.1.1

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

下载

• 常见翻车点：gen.go 里只写了 //go:generate go run gen.go，没加构建约束，结果 go build 尝试编译它，报 undefined: XXX
• 正确写法：第一行是 //go:build ignore，紧接着一个空行，再写 package main
• CI 中慎用 -tags=all：它会让 //go:build ignore 失效，导致本该跳过的文件被加载

想让某个包“看起来像被排除”，唯一可靠做法是路径排除

比如你想让 internal/gen/ 下所有代码不参与构建和索引：

• 打开 Settings → Project → Project Structure → Directories
• 选中 internal/gen/ 目录，点击右侧 Excluded
• 确认后，该目录下所有文件在 GoLand 中变灰、不出现在 Find in Path 结果里，go build ./... 也不会扫描它
• 注意：这和 gitignore 无关，也不影响 go mod tidy 对依赖的解析

真正的难点从来不在“怎么配”，而在于混淆了 IDE 行为（索引/补全）、Go 工具链行为（build/list）、和运行时行为（是否执行）。三者用的不是同一套开关。