Go开发环境配置失败主因是PATH未生效、GO111MODULE=off及GOPROXY未配置，需先验证which go路径并加入shell配置，再设GO111MODULE=on和GOPROXY=https://goproxy.cn,direct，最后确保项目含正确go.mod。
Go 开发环境不是装完 go 命令就完事，真正卡住人的从来不是下载安装包，而是 go version 报 command not found、gopls 启动失败、go mod init 生成错误 module 名——这些问题全出在路径、模块模式和编辑器联动这三处。
为什么 go version 找不到命令
安装包确实装了，但 shell 根本没“看见” go。这不是 Go 的问题，是 PATH 没生效。
- macOS / Linux：运行
which go，没输出就说明 PATH 没加对；检查安装路径（通常是/usr/local/go/bin），把它追加到~/.zshrc或~/.bash_profile里的PATH变量中，然后执行source ~/.zshrc - Windows：用 PowerShell 运行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」里确认C:\Program Files\Go\bin（或你自定义的路径）进了用户或系统PATH - 别信安装器勾选的“添加到 PATH”——它只改注册表或 plist，不自动 reload 当前终端；关掉再重开终端，或手动 source 才算数
go mod init 为什么生成错的 module 名
常见现象：执行 go mod init 后，go.mod 里 module 名是 example.com/hello 或直接空着，甚至报 cannot find module root。
- 当前目录在
$GOPATH/src下时，Go 会按旧 GOPATH 规则推导 module 名，而不是用当前路径；切到任意非$GOPATH路径下再初始化 - 项目根目录下存在
vendor/目录，或环境变量GO111MODULE=off，会导致go mod init静默降级为 GOPATH 模式；先运行go env -w GO111MODULE=on，再删掉vendor/ - module 名建议用域名前缀（如
github.com/yourname/project），避免本地路径（如./myproject）——后者会导致依赖解析失败
VS Code 里 gopls 一直 “Starting…”
gopls 不是插件装上就跑，它要同时满足三个条件才能启动：
立即学习“go语言免费学习笔记（深入）”；
-
go命令必须全局可用（which go有输出） - 当前打开的文件夹必须含
go.mod（或至少有个.go文件且在 module 根目录下） - 文件后缀得是
.go，且不能是_test.go单独打开——VS Code 会误判为测试文件而不激活gopls - 如果提示 “failed to load view for …”，大概率是
go.mod里 import 路径写错了，或go.sum校验失败；可临时删掉go.sum，再运行go mod tidy
国内环境下依赖拉不下来怎么办
不是网络差，是默认代理 https://proxy.golang.org 在国内不可达，必须显式换源。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（阿里云镜像也行：https://mirrors.aliyun.com/goproxy/） - 顺手加上校验开关：
go env -w GOSUMDB=off（开发阶段可关，上线前建议恢复为sum.golang.google.cn） - 注意：VS Code 的 Go 插件有时会忽略全局
GOPROXY，需在工作区.vscode/settings.json里补一句"go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn" }
最常被跳过的其实是 GO111MODULE=on 和 GOPROXY 这两个环境变量——它们不写进 shell 配置，每次新开终端就得重设；一旦漏掉，后续所有操作都在“假装有模块”的状态里打转。
