GoLand新建Go项目必须选“Go Module”并手动配置GOROOT指向Go安装根目录（如C:\Go）、设置合理模块名（如example.com/myapp）、确保工作目录为含go.mod的项目根，否则go run会报错或运行按钮灰显。
GoLand 新建项目时选 Go Module 就能自动构建模块，但“自动”不等于“免配置”——GOROOT 指错、模块名留空、工作目录错位，三者任一出问题，go run 就会报 cannot find package fmt 或直接灰掉运行按钮。
GOROOT 必须指向 Go 安装根目录，不是 bin 子目录
GoLand 不读系统环境变量里的 GOROOT，只认自己设置的路径。填错最常见两种情况：
- 填成
C:\Go\bin或/usr/local/go/bin（缺src目录，gopls启动失败，fmt 标红且无法跳转） - Windows 下装在
C:\Program Files\Go（路径含空格，触发exec: "gcc": executable file not found类错误）
正确路径示例：C:\Go、D:\Go、/usr/local/go、/usr/local/opt/go/libexec（macOS Homebrew 安装位置）。改完必须关闭并重启 GoLand，点 Apply 无效。
新建项目必须选 Go Module，不能选 Empty Project
Go 1.16+ 默认强制启用 modules，选错初始化方式会导致后续所有依赖管理失效：
-
Empty Project：不生成go.mod，import语句全标红，go list -m报no modules found -
Go Module：自动执行go mod init <module-name></module-name>，生成最小化go.mod文件 - 模块名别用
main或留空，推荐example.com/myapp或github.com/username/repo；否则go get会失败
如果误选了 Empty Project，不用删重来，在终端进项目根目录手动跑 go mod init example.com/myapp 即可补救。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
go.mod 生成后，必须确认 IDE 正确识别模块根目录
go.mod 文件存在 ≠ GoLand 认它为 module 根。IDE 只在满足以下全部条件时才激活模块感知：
-
go.mod在你打开的项目最顶层文件夹下（不是子文件夹里） - 没有同级的
go.work文件（有就删掉） - GoLand 是以“文件夹方式”打开整个根目录，不是双击
main.go单文件打开 - 右下角状态栏显示
gopls (running)和你的模块名（如example.com/myapp）
命令行快速验证：在项目根目录执行 go list ./，输出 command-line-arguments 才算真正生效。
运行前务必检查 Run Configuration 的 Working directory
GoLand 首次运行 main.go 会自动生成一个 Go Build 配置，但 Working directory 默认可能不是项目根目录：
- 右键
main.go→Run 'main.go'，首次运行后点击右上角下拉菜单 →Edit Configurations… - 检查
Working directory是否为含go.mod的那个文件夹路径 - 如果不对，手动改成项目根目录，否则
go run会因找不到模块而失败
真正容易被忽略的是：GOENV（或 GOPATH）设置虽不影响 go run，但会影响 go install、go test -i 等命令；若项目要引用本地开发的其他包，得用 replace 显式指向，而不是指望 GOPATH 自动发现。
