GoLand的“Excluded”仅过滤IDE视图，不影响go build；若目录仍参与构建，需确认是否被import或缺少//go:build ignore约束，且须关闭自动构建与File Watchers。
GoLand 排除目录后仍被自动构建？先确认是否真“排除”了
GoLand 的“Excluded”只是视觉过滤，不影响 go build 行为——它不改构建逻辑，只让 IDE 忽略那些目录的索引、补全和查找。如果你发现标为 Excluded 的目录下文件仍参与构建或报错，大概率是：go build 本身在扫描整个包路径，而你没用构建约束（//go:build）或路径隔离真正切断编译链。
- 右键目录 → Mark Directory as → Excluded 后，图标变灰，但该目录若仍在当前模块的 import 路径中（比如
import "myproj/internal/gen"），go build ./...仍会解析它 -
Excluded状态只影响 GoLand 自身行为（如 Find in Path、重构分析），gopls语言服务器默认也会跳过，但某些插件或自定义脚本可能绕过它 - 如果目录里有
.go文件且未加//go:build ignore，又恰好被某个包 import，那它一定会进构建流程——IDE 的 Excluded 对此完全无效
怎么让 GoLand 真正不触发对某目录的自动构建检查
GoLand 的 “Build project automatically” 默认会监听文件保存，调用 go list 和轻量构建检查。要让它彻底不碰某个目录，得从两个层面入手：禁用 IDE 主动扫描 + 切断构建路径依赖。
- 关闭 Settings → Go → Build Tags & Vendoring → Build project automatically
- 关掉 Settings → Tools → File Watchers 中所有 Go 相关 watcher（如
go fmt、go vet触发器） - 确保该目录不在任何
import路径中；若必须保留 import（如用于生成代码），则在目录内每个.go文件顶部加//go:build ignore并紧接空行 - 不要依赖
.gitignore或go build -o /dev/null来“排除”，前者对构建零影响，后者照常解析全部源码
vendor、gen、dist 这类目录该用 Excluded 还是其他方式？
对 vendor、gen、dist、build 这类纯生成/缓存目录，Excluded 是最安全、最标准的做法——它们本就不该参与语义分析，也不该出现在补全列表里。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
vendor/必须Excluded：否则 GoLand 会尝试索引所有第三方代码，拖慢启动和导航，且可能干扰gopls的模块解析 -
gen/或tmp/类目录也建议Excluded，尤其当里面含大量自动生成的桩文件（如 protobuf 生成代码），否则 IDE 常报undefined: XXX（因类型尚未生成） - 绝不能
Excludedinternal/、pkg/、cmd/：这些是 Go 模块语义结构的一部分，exclude 后会导致 import 解析失败、重构中断、甚至go run在 IDE 内无法启动 -
Excluded配置保存在.idea/modules.xml，不随 Git 提交；团队需统一约定，或通过.idea/misc.xml中的sharedIndex配置同步部分规则
为什么改了 Excluded 还看到 vendor 里的错误提示？
常见现象：vendor/github.com/some/lib/file.go 明明已 Excluded，但 GoLand 仍提示 func undefined 或高亮红色。这不是 Excluded 失效，而是 gopls 或 GoLand 的 module resolver 仍通过 go list 获取了该包的接口信息，并缓存在内存中。
- 重启 GoLand 或手动触发 File → Reload project from disk，强制刷新 module 索引
- 检查
Settings → Go → Language Server是否启用了build.ignore，它可配置忽略路径前缀（如vendor），比 Excluded 更底层 - 运行
go clean -cache清掉$GOCACHE，避免旧构建产物干扰语言服务器判断 - 如果错误来自
gopls日志，注意它有时会 fallback 到 vendor 下的go.mod解析——此时应确认根项目go.mod是否正确 require 了对应版本，而非依赖 vendor 的副本
真正起作用的永远不是“隐藏”，而是“不被引用”和“不满足构建条件”。Excluded 只管 IDE 视图，//go:build ignore 才管编译器，两者配合才稳。
