GoLand自动构建不提供文件过滤，真正排除文件靠//go:build ignore注释（需紧贴首行且后跟空行）和IDE的Excluded目录机制；前者控制编译，后者仅视觉隐藏，二者不可混用。
GoLand 的“自动构建”本身不提供按文件过滤功能，它依赖的是 Go 工具链的构建约束（build tags）和 IDE 的目录排除（Excluded）机制——两者作用不同、生效层级也不同，混用容易失效。
GoLand 自动构建真正忽略文件靠的是 //go:build 注释
GoLand 启用 “Build project automatically” 后，底层调用的是 go list + go build，所以是否编译某个 .go 文件，完全由 Go 构建约束决定，IDE 不额外加逻辑。
- 在目标文件顶部第一行写
//go:build ignore，紧接着必须是一个空行，再写package声明 - 运行
go list -f '{{.GoFiles}}' ./验证：如果输出里还包含该文件名，说明注释格式错（比如多了空格、没空行、用了/* */） - 不要只依赖文件名后缀（如
gen.go），go build会照常编译它，除非加了有效构建约束 - CI/CD 中若用
go build -tags=all，//go:build ignore会被绕过——因为all标签会让所有文件参与构建，应改用显式白名单标签（如-tags=prod）
GoLand 项目视图中“隐藏”文件夹只能用 Excluded
所谓“屏蔽”只是视觉过滤，不影响编译，但能大幅减少干扰。这和构建无关，纯属 IDE 层面的显示控制。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 右键点击目录（如
build/、dist/、gen/）→ Mark Directory as → Excluded - 被 exclude 的目录图标变灰，不会出现在
Find in Path、代码补全、重构分析中 -
internal/、pkg/、cmd/绝对不能 exclude——它们是 Go 编译器和gopls理解依赖的关键路径，exclude 后会导致跳转失败、测试找不到包、go list报错 - Excluded 状态保存在
.idea/modules.xml，默认不提交到 Git；若团队共用，需统一配置或文档说明
别踩这些坑：.gitignore、文件权限、go:generate 都不管用
很多做法看似“屏蔽”，实则对 GoLand 自动构建零影响，甚至引入新问题。
-
.gitignore只影响 Git 提交，go build和 GoLand 完全无视它 - 用
os.Chmod(path, 0400)或 Windowsattrib +h设为只读/隐藏，GoLand 不识别文件系统隐藏属性，仍会索引和报错 -
//go:generate是代码生成指令，不是构建开关；没加//go:build ignore的gen.go仍会被编译，大概率因缺少生成物而报undefined: XXX - 手动删
.go文件再go build？临时可行，但 GoLand 缓存可能残留符号引用，且无法进版本控制
最易被忽略的一点：GoLand 的自动构建触发的是 go list，而 go list 的结果直接决定哪些文件进入后续编译流程。验证时别只看 IDE 是否标红，一定要跑 go list -f '{{.GoFiles}}' ./ 看真实参与构建的文件列表——这才是唯一可信的判断依据。
