goland正常运行go代码的前提是系统中go命令可用且配置正确；需确保go version能输出版本号、goroot路径手动指定、goproxy代理设为https://goproxy.cn,direct并验证生效。
GoLand 能正常运行 Go 代码，前提是 go 命令本身在系统中可用且配置正确。只要 go version 能输出版本号，GoLand 就能识别并使用它——不是 GoLand 决定环境是否 OK，而是底层 go 工具链是否就位。
Go SDK 必须先装好，且 go 命令要能在 cmd/PowerShell 中直接调用
GoLand 是 IDE，不自带 Go 编译器。它依赖系统 PATH 中的 go 可执行文件。如果安装完 Go 后在命令行输入 go version 报错“不是内部或外部命令”，说明 PATH 没生效，GoLand 启动时也会提示找不到 SDK。
- 推荐用官网 .msi 安装包（如
go1.23.4.windows-amd64.msi），默认路径C:\Program Files\Go最稳妥，自动写入 PATH - 若自定义安装路径（如
D:\Go），必须手动把%GOROOT%\bin（即D:\Go\bin）加进系统 PATH - 安装后重启终端或重新登录 Windows，再运行
go version验证；别只信“安装完成”弹窗 -
GOROOT一般不用手动设——除非你改了安装路径且没加 bin 到 PATH；GOPATH在 Go 1.16+ 的 module 模式下已非必需，可不配
GoLand 安装时勾选 “Add launchers dir to the PATH” 才能从任意位置启动
这个选项决定你能否在项目文件夹里右键 → “Open in GoLand”，或在终端直接敲 goland 启动。不勾选的话，只能靠桌面快捷方式或开始菜单打开，对命令行工作流很不方便。
- 安装过程中的 “Add launchers dir to the PATH” 必须勾选，否则后续要手动把 GoLand 的 bin 目录（如
D:\Soft\GoLand\bin）加进 PATH - “Associate .go files” 勾选后，双击
.go文件会默认用 GoLand 打开，省去右键选择 - 安装路径避免中文、空格、符号（如
D:\GoLandOK，D:\My Tools\GoLand或D:\编程工具\GoLand会导致插件加载失败或调试异常
首次启动后必须手动指定 GOROOT，否则新建项目无法识别 SDK
GoLand 不会自动扫描系统 PATH 里的 go，它需要你明确告诉它 Go 安装在哪。即使 go version 在终端能跑，IDE 里仍可能报 “No SDK configured”。
- 启动 GoLand → 新建项目 → 出现 “No SDK configured” 提示时，点右侧 “Configure SDK” → “Add SDK” → “Go SDK”
- 路径选到
GOROOT下的bin目录上级，比如D:\Go或C:\Program Files\Go，不是选go.exe文件本身 - 确认后，GoLand 会自动读取
go env输出并校验；若提示 “Invalid Go SDK path”，大概率是选错了目录（比如选到了bin子目录） - 如果之前配过错误路径，可在
File → Settings → Go → GOROOT里修改，改完要重启项目或重载 SDK
模块代理（GOPROXY）必须设，否则 go get 会卡死或失败
国内直连 proxy.golang.org 基本不可用，不设代理会导致 go mod download 超时、依赖拉不下来、甚至新建项目卡在 “Loading modules…” 状态。
- 设置方式：终端运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/,direct - 验证：运行
go env GOPROXY，输出应为设定值；若为空或仍是默认值，说明没生效（注意-w参数不能漏） - GoLand 内部调用
go命令时会继承系统环境变量，所以只需全局设一次，IDE 自动感知 - 顺手关掉校验（可选）：
go env -w GOSUMDB=off，避免因 checksum 失败导致go mod tidy中断
最常被跳过的其实是 GOPROXY 设置——很多人以为装完就能写代码，结果新建项目后 import 第三方包就卡住，反复刷新、重启 IDE 都没用，最后才发现是代理没开。这一步没做，后面所有依赖管理都会出问题。
