goland不能开箱即用写代码，必须手动配置goroot并重启、启用go modules并设置goproxy（如https://goproxy.cn,direct）、安装gopls和dlv，否则新建项目失败、跳转失效、断点不触发。
GoLand 能否立刻写代码、点运行就出结果，取决于它是否真正“认得”你本地的 Go 工具链——不是系统能跑 go version 就行，IDE 必须自己找到 GOROOT、加载模块、启动 gopls，三者缺一不可。否则新建 main.go 后右上角三角灰掉、import 标红、测试函数不识别，都是必然现象。
GOROOT 必须手动指定且重启生效
GoLand 不继承系统 PATH，也不会自动探测 go 命令位置。即使终端里 go version 正常，IDE 仍可能报 “No Go SDK found”。
- 打开 Settings → Go → GOROOT，点击右侧文件夹图标，选择 Go 安装根目录（macOS 是
/usr/local/go或/opt/homebrew/opt/go/libexec；Windows 是C:\Go，不是C:\Go\bin） - 确认该路径下存在
src、pkg、bin三个文件夹；若用 Homebrew 安装，路径通常是/opt/homebrew/opt/go/libexec -
点 Apply 后必须完全退出 GoLand 再重开，仅 Reload project 或点击 Sync 无效——GUI 进程不重启，
GOROOT就不会被重新读取 - 验证：新建
main.go，写fmt.Println("ok")，若无波浪线且右上角绿色三角亮起，说明通过
Go Modules 代理必须配对且清缓存
只勾选 “Enable Go modules integration”，却不设代理或漏掉 direct，会导致 go get 超时、私有模块解析失败、依赖标红。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进入 Settings → Go → Go Modules，勾选 “Enable Go modules integration”
-
Proxy栏填完整值：https://goproxy.cn,direct—— 注意逗号后有空格，且direct不可省略，否则内网模块或新版包会直接失败 - 删掉项目根目录下的
go.work文件（如果存在），它会强制启用多模块工作区，干扰单模块项目初始化 - 右键项目根目录 → “Reload project”，不是 “Sync”；必要时终端执行
go clean -modcache清旧缓存再重载
运行配置要匹配实际入口路径
点 main.go 旁的绿色三角却报 no Go files in current directory，大概率是工作目录或入口设置错位，而非代码问题。
- 编辑 Run Configuration →
Working directory推荐设为$ProjectFileDir$（项目根目录），避免路径解析混乱 - 若入口不在项目根目录（如
cmd/myapp/main.go），在Program arguments栏填./cmd/myapp，不要填main.go——go run main.go不走 module 解析，go run .才按go.mod加载依赖 - 确保
main.go在模块根目录或子目录中，且所在目录不含中文、空格或特殊符号（如~/Desktop/我的项目会导致go mod init失败）
gopls 和 dlv 缺失会导致智能提示和调试失效
没装 gopls，补全、跳转、重命名全瘫；没装 dlv，断点调试直接报 could not launch process，跟 IDE 配置无关。
- 终端执行：
go install golang.org/x/tools/gopls@latest，完成后运行gopls version确认输出 - 再执行：
go install github.com/go-delve/delve/cmd/dlv@latest，完成后运行dlv version - 检查 GoLand 的 Terminal 是否用了和系统一致的 shell（比如 macOS 上终端用 zsh，但 GoLand Terminal 设为 bash，PATH 就可能不一致）
- 首次打开项目时，IDE 弹出 “Some tools are missing” 提示，务必点 Install，别跳过
最易被忽略的是：GOROOT 指定后不重启 IDE、GOPROXY 少写 ,direct、运行配置混用 go run main.go 和 go run . 这三处。它们不出错则一切顺利，一出错就是“为什么写完代码却点不了运行”。
