Go环境真正搭好需满足三点：go version正常输出、go mod init不报错、go run main.go立即打印结果；Windows需检查PATH是否包含Go安装路径，Linux/macOS需确保/usr/local/go/bin在PATH中且go文件有执行权限，模块路径名须符合规范，国内需配置GOPROXY。
Go环境能跑起来，关键不在“装没装”，而在go version能正常输出、go mod init不报错、go run main.go能立刻打印结果——这三点通了，才算真正搭好了。
Windows上安装后go命令找不到？检查PATH是否漏加C:\Program Files\Go\bin
MSI安装包默认会写入系统PATH，但某些安全策略或旧版Windows（如Win10 LTSC）可能跳过这步。别信“安装完成”弹窗，手动验证：
- 打开CMD或PowerShell，执行
where go（Windows）或which go（Mac/Linux），无输出就说明PATH没生效 - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”里找到
Path，确认含C:\Program Files\Go\bin（注意路径末尾没有反斜杠） - 如果用的是非默认路径（比如自定义装到
D:\go），那必须手动添加D:\go\bin，不能依赖安装程序
Linux/macOS解压后go version报command not found？/usr/local/go/bin没进PATH或权限不对
tar解压本身不改环境变量，且/usr/local/go/bin/go文件若被chmod 000过，也会静默失败。实操建议：
- 先确认文件可执行：
ls -l /usr/local/go/bin/go，输出中应有x（如-rwxr-xr-x），否则运行sudo chmod +x /usr/local/go/bin/go - PATH配置要写对：在
~/.bashrc或~/.zshrc里加export PATH=$PATH:/usr/local/go/bin，不是export PATH=/usr/local/go/bin:$PATH（顺序错会导致系统命令失效） -
source ~/.zshrc后，再开新终端验证，别在当前终端反复source——Zsh会缓存PATH，旧终端不刷新
go mod init报cannot determine module path？当前目录名含空格或非法字符
Go Module初始化时会尝试从目录名推导模块路径，遇到空格、中文、连字符开头、数字开头等情况直接失败。这不是网络或代理问题，是路径规范问题：
立即学习“go语言免费学习笔记（深入）”；
- 项目目录名只能含小写字母、数字、下划线、短横线（但不能以短横线或数字开头），例如
hello-go合法，my project或123api非法 - 临时解决：用
go mod init example.com/myapp显式指定模块路径，绕过自动推导 - 长期建议：所有Go项目根目录统一用
snake_case命名，避免后续go get、go build在CI中出错
VS Code里gopls一直Installing？国内网络下必须配GOPROXY
VS Code的Go插件默认调用go install golang.org/x/tools/gopls@latest，而golang.org域名在国内解析慢甚至超时，导致卡死。这不是插件bug，是网络策略问题：
- 在终端执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐goproxy.cn，比proxy.golang.org稳定） - 重启VS Code，再新建
.go文件，右下角提示会秒变“Install All”，点击后gopls、dlv等工具几秒内装完 - 如果已卡住，先在终端运行
killall gopls（Mac/Linux）或任务管理器结束gopls.exe（Windows），再重试
环境变量一旦配错，后续所有go命令都会连锁失败；而错误信息往往不直接指向PATH或GOPROXY，容易在“是不是代理没开”“是不是插件坏了”里反复折腾。最省时间的做法：每配一个变量，立刻新开终端验证go version和go env GOPROXY。
