GoLand跑不起来主因是go命令不可用、GOROOT路径错误或未启用Go Modules；需终端验证go version，GOROOT须指向含src/pkg/bin的根目录并重启IDE，新建项目必须选Go module且配好GOPROXY。

GoLand 跑不起来，90% 是因为 go 命令不可用、GOROOT 指错了路径、或项目没启用 Go Modules —— 这三件事缺一不可，其他配置全是次要的。

终端里 go version 报错或无输出

GoLand 不会装 Go，它只调用你系统 PATH 里的 go。如果终端输 go version 失败，GoLand 的运行按钮一定灰色。

• Windows：检查 PATH 是否含 C:\Go\bin（或你自定义安装路径下的 bin 目录）；若手动改过安装路径但没加进环境变量，必须手动补上
• macOS/Linux：运行 echo $PATH 看是否含 /usr/local/go/bin；不含就编辑 ~/.zshrc 或 ~/.bash_profile，加一行 export PATH=$PATH:/usr/local/go/bin，再执行 source ~/.zshrc
• 验证方式：关掉所有终端窗口重开，再跑 go version；有输出才算过关

GoLand 设置里 GOROOT 总是识别错

GoLand 的 “Auto-detect” 在 2025+ 版本基本失效，尤其多版本共存或非标准路径下。它要的是 Go 安装根目录，不是 bin 子目录。

• 正确路径示例：/usr/local/go（macOS）、C:\Go（Windows），该目录下必须有 src、pkg、bin 三个文件夹
• 错误操作：点进 C:\Go\bin 选中，结果 GoLand 找不到 src，索引全崩，fmt 都标红
• 改完必须彻底退出 GoLand（包括后台进程），再重新启动；仅点击 “Reload project” 没用

新建项目后右上角运行按钮仍是灰色

根本原因：项目没启用 Go Modules。GoLand 2025 起对非模块项目支持极弱，连基础运行都拒绝。

GoLand 2026.1.1

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

下载

立即学习“go语言免费学习笔记（深入）”；

• 创建项目时，左侧选 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 不能少）

go env GOPROXY 显示为空或还是官网地址

GoLand 读取的是全局 Go 环境变量，不是 IDE 里设置的 Proxy。IDE 里填了不等于生效，得看 go env 输出。

• Windows 用户执行：go env -w GOPROXY=https://goproxy.cn,direct
• macOS/Linux 用户执行：go env -w GOPROXY=https://goproxy.cn,direct
• 执行完立刻验证：go env GOPROXY 应输出 https://goproxy.cn,direct；否则后续 go get 或依赖下载全卡住
• 注意：这个命令修改的是用户级环境变量，不需要重启系统，但已打开的终端需重开

最常被跳过的动作是：改完 GOROOT 后没彻底退出 GoLand，或新建项目时手快选了 “Empty Project” 而非 “Go module”。这两个动作一漏，后面所有配置都白搭。