goland不自带go运行时，必须单独安装go sdk并手动配置：下载go.dev/dl/的稳定版，安装后在file→project structure→project sdk中指向bin/go或bin\go.exe，确保终端可执行go version。

GoLand 本身不提供 Go 运行时，必须单独安装 Go SDK 才能编译运行代码——这是最常卡住新手的第一步。

GoLand 启动后提示 “No SDK configured” 怎么办

这不是 GoLand 的 bug，而是它故意不捆绑 Go 二进制。你得自己下载并指向已安装的 Go SDK。

• 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统的 go1.xx.x 安装包（推荐稳定版，别用 beta）
• 安装后确认终端能执行 go version；macOS/Linux 检查 $GOROOT 是否指向安装路径（如 /usr/local/go），Windows 一般在 C:\Go
• 在 GoLand 中：File → Project Structure → Project → Project SDK → Click “New…” → Go SDK → 选中 go 可执行文件（不是目录，是 bin/go 或 bin\go.exe）
• 注意：不要选错成系统里其他 Go 版本（比如通过 asdf 或 gvm 管理的版本），GoLand 会读取该 SDK 的 GOPATH 和 GOBIN 行为

Go module 初始化失败：go.mod 生成不了或报 “cannot find main module”

GoLand 默认按“模块感知模式”工作，但新建空目录时不会自动 go mod init，需手动触发或配置默认行为。

GoLand 2026.1.1

GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。

下载

• 新建项目时，在向导里勾选 “Create main.go” 并确保 “Initialize go modules” 被选中（GoLand 2023.3+ 默认开启）
• 已有目录没 go.mod？右键项目根目录 → “Go” → “Initialize Go Module”，输入模块名（如 example.com/myapp），不要留空
• 如果弹出错误 go: cannot find main module，大概率是当前目录不在 GOPATH/src 且没 go.mod——此时别切 GOPATH 模式，直接补 go mod init
• 避免在 $GOPATH/src 下混用 GOPATH 模式和 module 模式，GoLand 会优先走 module，旧式 GOPATH 项目建议显式关闭 “Enable GOPATH mode”（Settings → Go → GOPATH）

调试时断点不生效或提示 “Delve not installed”

GoLand 调试依赖 dlv（Delve），它不是 Go 自带组件，必须独立安装并被 IDE 识别。

• 终端执行 go install github.com/go-delve/delve/cmd/dlv@latest（Go 1.16+ 必须用 @latest）
• 安装后检查 dlv version 是否输出正常；若提示 “command not found”，说明 GOBIN 或 $PATH 没包含安装路径（默认是 $GOPATH/bin 或 $HOME/go/bin）
• GoLand 设置里：Settings → Go → Debugger → Delve → 勾选 “Use built-in delve” 或手动指定 dlv 路径（推荐前者，新版内置版本较稳）
• 常见坑：用 root 权限安装了 dlv，但 GoLand 以普通用户运行，导致找不到；或者 macOS 上 Gatekeeper 拦截了未签名的 dlv，需在“安全性与隐私”里允许

模块代理、本地 replace、CGO_ENABLED 这些细节能让环境瞬间变脆弱，但 GoLand 不会主动提醒你它们的存在——得自己看 go env 和 go.mod 里的 replace 或 exclude 行。