goland 无法运行的90%原因是未正确配置go命令、goroot和go modules;需确保终端可执行go version、手动指定goroot并彻底重启ide、新建项目必须选go module模式且配置goproxy.cn代理。

GoLand 跑不起来,90% 是因为没配对 go 命令、GOROOT 和 Go Modules 这三样 —— 其他设置全可后补,这三项漏一个,右上角运行按钮就永远灰色。
确认终端能识别 go 命令
GoLand 不装 Go,只调用你本地的 go 二进制。它找不到 go,就什么也干不了。
- 打开系统终端(不是 GoLand 自带 Terminal),执行
go version;必须有输出,例如go version go1.24.0 darwin/arm64 - Windows 用户:如果用 .msi 安装但自定义了路径(比如
D:\Go),得手动把D:\Go\bin加进系统 PATH;加完必须关掉所有 CMD/PowerShell 窗口再重开 - macOS/Linux 用户:检查
echo $PATH是否含/usr/local/go/bin(或你实际安装路径下的bin);若没有,编辑~/.zshrc或~/.bash_profile,追加export PATH=$PATH:/usr/local/go/bin,然后source一下
手动指定 GOROOT 并彻底重启 GoLand
GoLand 2025+ 的 “Auto-detect” 在多版本或非标路径下基本失效。它需要你明确指向根目录,且必须看到 src、pkg、bin 三个文件夹。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 进入
Settings → Go → GOROOT(macOS 是Preferences),点击右侧文件夹图标,选择 Go 安装根目录 —— 比如/usr/local/go(macOS)、C:\Go(Windows),不是 里面的bin子目录 - 点
Apply后,必须关闭整个 GoLand 进程(包括后台残留),再重新启动;仅 “Reload project” 或 “Sync” 完全无效 - 验证方式:新建
main.go,写fmt.Println("ok"),看是否无波浪线、右上角绿色三角是否亮起
新建项目时必须选 Go module 模式
别用 “Empty Project”,也别等导入后再补模块。GoLand 2025 对非模块项目的索引和运行支持极弱,很多功能直接瘫痪。
- 启动 GoLand 后,选
New Project → 左侧选 Go → 右侧模式务必选 Go module,填模块名如example.com/hello(域名不重要,但不能纯数字或含空格) - 项目创建后,立刻检查根目录是否有
go.mod文件;如果没有,说明模块没启用,此时不要手动go mod init,而是删掉项目重来 - 国内用户必须配代理:进
Settings → Go → Go Modules,勾选Enable Go modules integration,Proxy填https://goproxy.cn,direct(注意逗号和direct,缺一不可)
最容易被忽略的是:GOROOT 指定后必须彻底退出 GoLand 再重进,以及新建项目时“Go module”选项是强制项而非可选项 —— 这两点一旦跳过,后续所有调试、依赖下载、代码跳转都会出问题,但错误提示往往藏得很深,不如直接重来省时间。










