GoLand不识别项目根目录本质是未激活Go Module模式，需确保go.mod存在且有效、位于打开的根目录、module名合法，并用File→Open重新加载。
GoLand 项目根路径没被识别，本质是 IDE 没把当前目录当 Go Module 项目处理——不是路径设错了，而是 go.mod 缺失、模块名不合法，或工作目录不在模块根下。
为什么新建项目后 GoLand 不认根目录
常见现象：打开一个含 go.mod 的文件夹，但 main.go 里 import 自定义包报红、go run 报 no modules found、右下角不显示 Go 图标。这不是路径配置问题，而是 GoLand 没触发“Module 模式”。它只在满足以下全部条件时才激活项目根：
-
go.mod文件存在且内容有效（至少含module example.com/myapp） - 当前打开的项目根目录 =
go.mod所在目录（不能是它的子目录） -
go.mod中声明的module名与实际 import 路径能对齐（比如import "example.com/myapp/utils"，就不能写成module myapp）
go.mod 存在但 GoLand 仍不识别根目录
即使 go.mod 在项目根，IDE 也可能静默跳过识别。重点检查三处：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确认
go.mod是 UTF-8 编码，无 BOM；Windows 上用记事本另存为时容易带 BOM，导致解析失败 - 检查
go.mod第一行是否为module声明，且后面跟的是完整路径（不能是module .或空字符串） - 右键项目根 →
Reload project，强制刷新模块状态；如果菜单灰掉，说明 IDE 根本没检测到go.mod
手动指定项目根目录无效怎么办
GoLand 不支持“手动指定根目录”这种操作——它只根据 go.mod 位置自动推导。所谓“设置根路径”其实是误操作，真正要做的只有两件事：
- 确保终端里
cd到项目根后，执行go list -m能输出模块名；如果失败，先在终端运行go mod init example.com/myapp - 在 GoLand 中关闭当前项目，重新用
File → Open选中含go.mod的那个文件夹（不是它的父目录，也不是子目录） - 不要用
File → New Project后再拖文件进来——这容易让 IDE 以“Empty Project”模式加载，失去模块感知
多模块项目里子目录不被识别为独立根
如果你有类似 ./cmd/app 和 ./internal/pkg 这种结构，GoLand 默认只认顶层 go.mod。想让子目录也被当作独立模块根，必须在子目录里也放一个 go.mod（哪怕只是占位），然后重新用 Open 单独打开该子目录。
注意：replace 指令不会让子目录变成模块根；go.work 文件目前（2026.2 版本）在 GoLand 中支持有限，仍建议单模块优先。
