goland通过“excluded”机制在项目视图中过滤特定目录，而非操作系统级隐藏；适用目录包括vendor、build、dist等生成目录，但internal、pkg等语义化目录绝不可exclude，否则破坏编译与ide功能。
GoLand 本身不提供“隐藏文件夹”的操作系统级功能，它只支持在项目视图中**过滤/排除显示**特定路径。真正起作用的是 IDE 的“Excluded”机制和文件系统层面的隐藏标记，二者目的不同、生效范围也不同。
哪些文件夹该用 Excluded 排除显示
Excluded 是 GoLand 最常用、最安全的“视觉隐藏”方式，适用于：vendor、node_modules（如果混用前端）、build、dist、.idea（不建议手动 exclude，但有时会误加）、自定义生成目录（如 gen 或 tmp）。
这些目录的特点是：内容由工具生成、不参与编译逻辑、不需被 Go 工具链扫描、且频繁变更容易干扰导航。
- 右键点击目标文件夹 → Mark Directory as → Excluded
- 被 exclude 后，该目录图标变灰，不会出现在 GoLand 的代码补全、Find in Path、重构影响分析中
- 注意：
internal和pkg这类语义化目录绝不能 exclude —— 它们是 Go 编译器和 IDE 理解依赖关系的关键路径 - Excluded 状态保存在
.idea/modules.xml中，属于项目级配置，不随 Git 提交（除非你主动提交 .idea）
为什么不用 os.Chmod + 0400 隐藏文件夹
网上有教程教你在 Go 里调用 os.Chmod(path, 0400) 来“隐藏”文件夹，这在 Windows 上根本无效，在 macOS/Linux 上只是设为只读，和隐藏无关。
更关键的是：GoLand 不识别或响应文件系统的隐藏属性（如 Windows 的 FILE_ATTRIBUTE_HIDDEN 或 macOS 的 .DS_Store 规则）。即使你用命令行执行了 attrib +h，GoLand 项目视图照样照常显示。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- Windows 下真正的隐藏需调用 WinAPI
SetFileAttributes，Go 标准库不封装此能力，需借助golang.org/x/sys/windows - 但即便隐藏成功，GoLand 仍可能因缓存或扫描策略继续索引该路径，反而导致 inconsistent behavior（比如符号跳转失效但文件又看不见）
- 这种做法破坏跨平台一致性，也违背 GoLand 的设计模型——它依赖明确的项目结构声明，而非文件系统侧信道
对 internal/pkg/cmd 等标准目录的常见误操作
大型单体项目常把 internal 目录误认为“可隐藏区域”，这是危险误区。
internal 虽限制导入可见性，但它必须被 GoLand 正常识别和索引，否则会导致：go list 报错、代码跳转中断、test runner 找不到测试包、refactor 提示“package not found”。
- 如果你看到
internal下的包在编辑器里标红、无法跳转，请检查是否被意外标记为 Excluded 或被go.mod的replace规则干扰 -
pkg目录同理：它是为外部复用设计的公共库入口，IDE 必须能解析其导出符号 - 真正可考虑 exclude 的，是
internal/xxx/gen这类子路径——只要确保父级internal/xxx本身未被 exclude
批量排除与配置同步技巧
单体项目往往有几十个生成目录，逐个右键 exclude 效率低且易漏。推荐两种可靠方式：
- 在 Settings | Directories 页面，点击 + Add Content Root 下方的 Exclude 按钮，支持通配符匹配（如
**/target、**/out），但注意 GoLand 的通配符不支持**/*.log这类文件级排除 - 通过
.gitignore联动：GoLand 默认将.gitignore中的路径自动标记为 Excluded（需开启 Settings | Version Control | Git | Use .gitignore to exclude files） - 若团队协作，把 exclusion 规则写进
.idea/misc.xml并提交（需协调团队接受该文件入 Git），避免每人重复配置
最易被忽略的一点：Excluded 只影响 IDE 视图和索引，不影响 go build 或 go test 行为。如果你发现构建失败却找不到原因，先确认报错路径是否被 exclude 后“看不见但实际存在”。
