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
下载
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，后者让所有依赖操作失败。这两步没做对，后面写的代码再漂亮也跑不起来。
