go环境能跑起来的核心是：go命令可用、goroot指向正确根目录、goproxy配置为https://goproxy.cn,direct；三者缺一不可，否则go run main.go报错、ide功能异常、依赖无法下载。
Go 环境能跑起来，核心就三件事：go 命令可用、GOROOT 指对、模块代理通。其他全是锦上添花，先让 go run main.go 不报错，再谈开发效率。
验证 go 命令是否真可用
很多人卡在第一步：终端里敲 go version 报 “command not found” 或版本太低（如 go1.18），VSCode/GoLand 就直接废掉一半功能。
- Windows 用户：打开 PowerShell 或 CMD，运行
where go（不是which）；如果没输出，说明 PATH 没生效——.msi安装默认会加%GOROOT%\bin到系统 PATH，但若你改过安装路径（比如装到D:\Go），就得手动检查环境变量里PATH是否包含D:\Go\bin - macOS/Linux 用户：运行
which go，再执行ls -l $(which go)，确认它指向的是你预期的 Go 安装位置（比如/usr/local/go/bin/go），而不是 Homebrew 装的旧版 - 版本必须 ≥
go1.21：低于这个版本，gopls和 GoLand 的泛型支持会降级甚至失效；运行go version看输出，不满足就重装最新稳定版（当前是go1.25.x）
GOROOT 不要乱设，尤其别填 /bin/go
GoLand 或 VSCode 提示“GOROOT not found”，很多人手抖把路径设成 C:\Go\bin\go.exe 或 /usr/local/go/bin，这是最常见误操作。
-
GOROOT必须是 Go 安装根目录，里面得有src、pkg、bin三个文件夹——Windows 默认是C:\Program Files\Go（不推荐，含空格易出问题），更稳妥填C:\Go；macOS 是/usr/local/go；Linux 一般是/usr/local/go或解压到$HOME/go-install - GoLand 中设置后，必须重启 IDE，点 “Reload project” 没用；VSCode 中改了系统
GOROOT环境变量后，也得关掉所有窗口再重开 - 如果你没手动改过，且
go version能正常输出，那大概率GOROOT已被自动识别，不用额外配置——强行指定反而容易冲突
Go Modules 代理不配好，go mod download 就是死循环
新建项目后 go mod init myapp 成功，但一加 import "github.com/gin-gonic/gin" 就卡住或报 timeout，基本就是代理没生效。
- 执行命令强制写入国内代理：
go env -w GOPROXY=https://goproxy.cn,direct——注意结尾的,direct不能少，否则私有仓库或本地模块会解析失败 - 不要只信 IDE 里的图形化设置：GoLand 的
Settings → Go → Go Modules → Proxy字段填了，不代表全局生效；VSCode 的 Go 扩展有时会忽略它，优先以go env GOPROXY输出为准 - 验证方式：在空目录下执行
go mod init test && go get github.com/go-sql-driver/mysql@v1.7.1，10 秒内完成即为正常；超时就回去检查go env GOPROXY输出是否匹配
测试文件命名和运行路径不匹配，go test 直接静默失败
写了 hello_test.go，里面 func TestHello(t *testing.T) 也规范，但 go test 什么也不输出，或者提示 no test files。
- 测试文件名必须以
_test.go结尾，且和待测代码在同一个包下（package main里不能有测试函数，必须另建package hello） - 运行
go test时，当前工作目录得是包含go.mod的模块根目录，或至少是含测试文件的包目录；在 GoLand 里右键运行测试，IDE 默认用$FileDir$当前路径，但如果项目结构是cmd/myapp/main.go+internal/hello/hello.go+internal/hello/hello_test.go，就得确保你在internal/hello目录下触发测试 - Windows 下路径大小写不敏感，但 Go 的模块导入路径是严格区分大小写的；比如
import "./MyLib"在 Windows 上可能通过，但 CI 或 Linux 构建直接失败
真正卡住人的从来不是语法，而是 go 命令找不到、GOROOT 指偏了、代理连不上这三处。只要它们稳了，go run、go test、go build 就是确定性行为，后续所有工具链才能建立信任。其他配置项，都是等项目跑通后再按需打开的开关。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
