GoLand 中无法真正“禁用”未完成模块，必须通过构建约束（如 //go:build ignore）配合目录隔离和 import 链切断来实现；//go:build ignore 必须位于文件首行且与 package 间仅一个空行，否则无效。
GoLand 里怎么让未完成模块不参与编译
GoLand 本身不提供“动态开关”来临时禁用某个模块，真正起效的是 Go 编译器的构建约束（build tags）——IDE 只是忠实执行 go build 的逻辑。你看到的“模块红了”或“test 跑不过”，往往不是模块被“屏蔽”了，而是它被错误地纳入了当前构建上下文。
为什么加了 //go:build ignore 还报错
常见现象：在 unfinished_feature.go 文件顶部写了 //go:build ignore，但 GoLand 仍提示 undefined、import cycle 或 test 失败。原因很直接：
-
//go:build ignore必须写在文件**第一行**，且与package声明之间**必须有且仅有一个空行**；多一个空行、少一个空行、混用// +build ignore都会失效 - GoLand 默认启用 Go Modules 模式，如果该文件所在目录下有
go.mod，且它被其他已启用的.go文件 import（哪怕只是间接引用），ignore标签也救不了它——因为 import 图已形成，编译器会在解析阶段就报错 - 别把
gen.go或mocks.go放进主包还指望靠ignore躲过类型检查；它们一旦被go list扫到，就会触发语法/语义校验
正确做法：用构建约束 + 目录隔离双保险
想让未完成模块彻底“消失”，不能只靠单个文件打标签，得从结构上切断依赖链：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 把未完成代码挪到独立子目录（如
unfinished/），并在其go.mod中不声明任何 module path（即不初始化模块），这样go build ./...不会递归进去 - 若必须保留在主模块内，给整个目录加统一前缀，比如
unfinished_feature_dontbuild.go，再配合//go:build !dontbuild—— 注意这是“反向排除”，要确保你没在命令行传-tags=dontbuild - 在 GoLand 的 Settings → Go → Build Tags 里清空默认 tag 输入框（不要填
ignore），否则 IDE 会强制启用它，导致本该跳过的文件反而被加载 - 验证是否真跳过：终端运行
go list -f '{{.GoFiles}}' ./unfinished，输出应为空或不含目标文件名
CI/CD 和本地开发要保持一致
很多人本地用 //go:build ignore 看似 OK，但 CI 流水线里跑 go test ./... 却失败。关键点在于：
- CI 脚本里别用
-tags=all——它会强制启用所有标签，包括ignore，结果本该跳过的文件全被编译进来 - GoLand 的 Run Configuration 若手动加了
-tags=ignore，而终端没加，就会出现“IDE 能跑、命令行报错”的割裂现象 - 最稳的方式是：未完成模块不放 main 包路径下，也不出现在任何
import链中；哪怕只是临时注释掉import _ "./unfinished"这一行，都比依赖构建约束更可靠
构建约束不是开关，是编译器的“条件过滤器”；它只在 go build 阶段起作用，对语法检查、IDE 索引、test 发现这些前置流程无效。真正安全的屏蔽，永远始于目录结构和 import 关系的主动控制。
