GoLand需手动安装Go并配置PATH，GOROOT必须正确设置，新建项目须勾选Initialize go module，main包文件需位于模块内且含func main()。
GoLand 本身不提供 Go 运行时，go 命令必须独立安装并加入 PATH，否则所有项目创建、依赖下载、运行调试都会失败——这是新手最常卡住的第一步。
确认系统已正确安装 Go 并配置环境变量
GoLand 不会帮你装 Go，它只读取系统 PATH 中的 go 可执行文件。常见错误包括：
- 只下载了 Go 安装包但没运行安装程序（macOS/Linux 需手动解压 + 配置
GOROOT和PATH） - Windows 上安装了 MSI 却勾选了「Add to PATH」但未重启终端或 IDE
-
go version在终端能运行，但在 GoLand 终端里报command not found（说明 IDE 没继承系统环境）
验证方式：在终端中运行
go version，再打开 GoLand 内置 Terminal（
Alt+F12），同样执行该命令。两者输出必须一致且非空。
在 GoLand 中指定正确的 GOROOT 和 GOPATH
GoLand 1.22+ 默认使用 Go Modules，GOPATH 已非必需，但 IDE 仍需知道 GOROOT 才能索引标准库和启用语法检查。
立即学习“go语言免费学习笔记（深入）”；
-
GOROOT：指向 Go 安装根目录（如/usr/local/go或C:\Go），不能指向bin子目录 -
GOPATH：若你仍用 GOPATH 模式开发（不推荐），需与go env GOPATH输出一致；若用 Modules，则可留空或设为任意路径（IDE 不会写入） - 设置入口：
File → Settings → Go → GOROOT（Windows/Linux）或GoLand → Preferences → Go → GOROOT（macOS）
新建项目时避免选择错误的初始化方式
创建新项目时，GoLand 会弹出「Initialize go module」选项，选错会导致后续 go get 失败或无法识别依赖：
- 勾选「Initialize go module」→ 自动生成
go.mod，推荐用于新项目（Modules 是当前唯一官方支持模式） - 不勾选 → 项目无
go.mod，IDE 以 GOPATH 模式解析，第三方包无法自动下载，go run可能报no required module provides package - 若已建错，不要手动删
go.mod后重试；应关闭项目，删掉整个目录，重新 New Project 并勾选初始化
初始化后，检查项目根目录下是否有
go.mod文件，内容至少包含
module example.com/hello 和 go 1.21（版本号取决于你安装的 Go）。
运行和调试前确保 main 包结构正确
GoLand 能自动识别 main 函数，但前提是文件属于 package main 且位于模块根目录或子目录中——否则 Run Configuration 会提示 No Go files in this directory 或找不到入口。
- 确保至少有一个
.go文件以package main
开头 - 该文件中必须有
func main() { ... }函数 - 如果代码放在
cmd/myapp/main.go，GoLand 默认不会自动发现；需右键该文件 →Run 'main.go'，或手动添加 Run Configuration，Target 设为File并选中该文件 - 调试时若断点灰色不可用，大概率是文件没被编译进当前 build target（检查 package 声明和文件位置）
模块路径、包名、文件位置三者不匹配，是 GoLand 中最隐蔽也最常被忽略的运行失败原因。
