go开发环境核心是确保go命令可执行、go mod能初始化、gopls能加载项目；其余配置均为服务这三点，需优先验证path、模块路径及代理设置。
Go 开发环境不是“装完就跑”，而是围绕 go 命令能否在任意目录可靠执行、go mod 能否干净初始化、gopls 能否正常加载项目这三件事展开的。其他所有配置——代理、编辑器插件、目录结构——都是为这三点服务的，不是越多越好。
go version 报 command not found 怎么办
这不是 Go 没装好，是 shell 找不到 go 二进制文件。关键不是“装了没”，而是“PATH 里有没有”。
- macOS/Linux：运行
which go；没输出就说明 PATH 没生效，检查安装路径（通常是/usr/local/go/bin）是否加进了~/.zshrc或~/.bash_profile，然后执行source ~/.zshrc - Windows：用 PowerShell 运行
Get-Command go；失败就去「系统属性 → 高级 → 环境变量」里确认C:\Program Files\Go\bin（或你自定义的路径）进了用户或系统 PATH - 别信安装器勾选的“添加到 PATH”——它只改注册表或 plist，不自动 reload 当前终端；重启终端或手动 source 才算数
go mod init 初始化失败的常见原因
go mod init 表面是生成 go.mod，实际在做模块路径推导。推导错，就静默失败或生成错误 module 名。
- 当前目录在
$GOPATH/src下：比如路径是~/go/src/myproject，go mod init会试图把 module 名设成myproject，但实际应是github.com/yourname/myproject；切到~/myproject这类非 GOPATH 路径再 init - 存在
vendor/目录：旧项目残留，go mod init可能绕过模块模式；删掉vendor/再试 -
GO111MODULE=off环境变量开着：运行go env -w GO111MODULE=on强制启用，Go 1.16+ 默认开启，但某些 CI 脚本或老终端可能关着
VS Code 里 gopls 启动失败怎么排查
gopls 不是插件装上就工作，它是个独立进程，依赖三样东西：可用的 go 命令、合法的模块结构、正确的文件后缀。
- 打开任意
.go文件，看右下角状态栏有没有 “Go” 标识；没有就说明gopls根本没起来 - 先确认
go version和go env在终端里能跑；gopls启动时会调用它们 - 项目根目录必须有
go.mod（哪怕刚go mod init出来），且当前打开的是该目录下的.go文件；打开单个main.go文件（没在模块根目录）会导致gopls降级为纯语法模式 - 如果提示 “Failed to start language server”，点通知里的 “Show Log” 查日志，通常第一行就是真实原因，比如 “go: command not found” 或 “no go.mod file”
国内环境下依赖下载慢或失败怎么办
根本问题是 golang.org/x/ 等包走不了 Google 域名，不是网络差，是 DNS 或防火墙拦截。靠改 GOPROXY 就能解决，不用折腾 hosts 或代理工具。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/ - 顺手加上
go env -w GOSUMDB=off（开发阶段可接受）或go env -w GOSUMDB=sum.golang.google.cn（严格校验，需配合代理） - 验证：运行
go get -u golang.org/x/tools/gopls，如果几秒内完成，说明代理生效；卡住超过 30 秒基本就是代理没起作用 - VS Code 插件安装失败（比如提示 “Installing tools…” 卡住），也是因为工具本身要
go get，同样受GOPROXY控制
真正容易被忽略的，是 go mod init 前的路径清理和 gopls 启动时的模块上下文判断——这两步没做对，后面配再多插件、换再快的镜像都没用。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
