GoLand 能直接运行 Go 代码的前提是本地已安装 Go SDK 并正确关联,必须手动配置 GOROOT 指向 Go 安装根目录(如 D:\Go),且需设置 GOPROXY 为国内镜像(如 https://goproxy.cn,direct),新建项目必须选择 Go Module 模式以生成 go.mod 文件。

GoLand 能直接运行 Go 代码的前提,是本地已装好 Go SDK 并正确关联——不是装了 GoLand 就能写代码,也不是装了 Go 就自动被识别。
Go SDK 必须先装好,且路径不能含中文或空格
GoLand 本身不带 Go 编译器,它只是个“指挥官”,真正干活的是你本地的 go 命令。所以第一步永远是装 Go SDK:
- 从
https://go.dev/dl/下载 Windows.msi安装包(别用第三方镜像站打包的“绿色版”,容易缺 bin 工具) - 安装时路径选纯英文、无空格的位置,比如
D:\Go或C:\go,绝对不要选桌面或“我的文档” - 装完立刻打开命令行执行
go version,看到类似go version go1.23.4 windows/amd64才算成功 - 如果报错“不是内部或外部命令”,说明
PATH没生效——检查系统环境变量里是否有D:\Go\bin(或你实际安装路径下的\bin)
GoLand 启动后第一件事:手动指定 GOROOT
新装的 GoLand 不会自动猜出你的 Go 安装位置,尤其当你没装在默认路径(如 C:\Go)时,GOROOT 为空就等于“没 SDK”。必须手动配:
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本,适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 启动 GoLand →
File → Settings → Go → GOROOT - 点击
+号,浏览到你安装 Go 的根目录(例如D:\Go),不是D:\Go\bin,也不是D:\Go\src - 配完点 OK,再新建项目时右下角状态栏应显示 “Go SDK: go1.23.4”
- 如果仍提示 “No SDK configured”,说明路径选错了,或者你装的是旧版 Go(低于 1.16)且未开启模块支持
GOPROXY 不设就拉不到依赖,国内必须配
Go 1.11+ 默认启用模块模式,但官方代理 proxy.golang.org 在国内基本连不上。不设代理,go mod tidy 或首次 import 第三方包时会卡住或报错:
- 错误现象:
go: github.com/sirupsen/logrus@v1.9.0: Get "https://proxy.golang.org/github.com/sirupsen/logrus/@v/v1.9.0.info": dial tcp 216.58.221.241:443: connectex: A connection attempt failed - 解决方法:命令行执行
go env -w GOPROXY=https://goproxy.cn,direct(direct表示私有模块走直连) - 验证是否生效:
go env GOPROXY应输出https://goproxy.cn,direct - GoLand 内部也会读这个配置,不用在 IDE 里重复设置——但如果你用的是老版本 GoLand(2022.3 之前),可能需在
Settings → Go → Go Modules里手动填一次
新建项目必须选 “Go Module”,否则依赖管理失效
GoLand 新建项目时,默认选项是 “Empty Project”,这种项目没有 go.mod,import 包不会自动下载,go run 也只认当前目录下文件,无法跨包引用。
- 创建项目时,务必选择
New Project → Go Module - Module path 填类似
example.com/myapp的域名格式(哪怕只是本地开发,也别填main或留空) - 创建后立刻检查项目根目录下有没有
go.mod文件,内容应包含module example.com/myapp和go 1.23 - 如果误选了 Empty Project,补救方式是:终端进项目根目录,执行
go mod init example.com/myapp,再删掉go.sum重跑go mod tidy
最常被跳过的其实是 GOROOT 配置和 GOPROXY 设置——前者导致 IDE 根本不认 Go,后者让所有依赖操作失败。这两步没做对,后面写的代码再漂亮也跑不起来。

















