关键是要正确配置goroot和goenv/gopath、初始化go modules；需手动设置goroot路径并验证bin/go存在，新建项目选go module并设合理模块名，确保go.mod生成且工作目录正确，再验证go run是否成功。
直接在 Goland 里新建 Go 项目，关键不是“建项目”，而是确保 GOROOT 和 GOENV（或 GOPATH）配置正确、模块初始化到位——否则新建出来的项目根本跑不起来，连 go mod init 都可能报错。
检查并配置 Goland 的 Go SDK 路径（GOROOT）
很多新手卡在第一步：Goland 没识别到本地 Go 安装。它不会自动猜，必须手动指定。
- 打开 File → Settings → Go → GOROOT（macOS 是 Go → GOROOT）
- 点击右侧文件夹图标，选择你本地 Go 的安装路径，比如：
/usr/local/go（macOS/Linux）或C:\Go（Windows） - 确认该路径下存在
bin/go（或bin\go.exe），否则 Goland 会标红提示“Invalid Go SDK” - 如果系统已配置
PATH且 Goland 能自动探测到，也建议手动核对一次——自动探测有时会选错旧版本
新建项目时选对初始化方式：Go Modules 优先
从 Go 1.16 开始，默认强制启用 modules；Goland 新建项目若仍用 GOPATH 模式，后续 import、依赖管理会处处受限。
- 新建项目时，选择 Go → Go Module（不是 “Empty Project” 或 “Go Application”）
- 填写项目名后，Goland 会自动执行
go mod init <module-name></module-name>，生成go.mod - 模块名建议用实际可解析的域名格式，比如
example.com/myapp，避免用main或空字符串——否则go get会失败 - 如果误选了 “Empty Project”，别删重来，进终端手动运行
go mod init example.com/myapp即可补救
项目结构生成后，立刻验证 go run 是否通
Goland 自动创建的 main.go 只是模板，但常因工作目录或模块状态异常导致运行失败。
- 确保当前项目根目录下有
go.mod文件，且内容非空 - 在 Goland 终端中执行
go list -m，应输出模块名；若报错no modules found，说明模块未激活，需cd到项目根目录再试 - 右键
main.go→ Run 'main.go'，首次运行时 Goland 会自动创建一个 Run Configuration，注意检查其Working directory是否为项目根目录 - 常见错误：
cannot load fmt: cannot find module providing package fmt—— 这基本是GOROOT指向错误或 Go 版本太低（低于 1.11）
真正容易被忽略的是：Goland 的 GOENV（或 GOPATH）设置虽不影响编译，但会影响 go install、go test -i 等命令的行为；如果项目要用到本地开发的其他包，得确保它们也在同一模块下，或通过 replace 显式指向，而不是指望 GOPATH 自动发现。
