go version报错或找不到是PATH未正确配置，需确保$GOROOT/bin加入PATH并重启终端或source配置文件；国内需设置GOPROXY和GOSUMDB代理；gopls需手动安装且$GOPATH/bin须在PATH中；Windows下CMD编码问题导致乱码，应切换UTF-8或改用PowerShell。
go version 命令报错或找不到，说明 PATH 没配对
这是最常卡住的第一步。不是 Go 没装，而是 shell 找不到 go 二进制。Windows 用户装完 .msi 后必须重启 CMD/PowerShell；macOS/Linux 用户改完 ~/.zshrc 或 ~/.bashrc 后必须执行 source ~/.zshrc，否则 PATH 不生效。
验证方式：运行 which go（macOS/Linux）或 where go（Windows），输出应为类似 /usr/local/go/bin/go 或 C:\Go\bin\go.exe。如果为空，就说明 PATH 里漏加了 $GOROOT/bin —— 注意不是 $GOROOT，是它的 bin 子目录。
go mod init 报错 “unknown revision” 或依赖拉不下来
这不是环境问题，是网络策略没打开。国内默认直连 proxy.golang.org 几乎必超时，必须设代理：
go env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.google.cn
这两条命令执行后，go mod tidy 就能立刻开始下载依赖。别用 https://goproxy.io —— 它已停服；也别用 direct 单独配置，它必须跟在逗号后面作为 fallback。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
VS Code 提示 “gopls not found”，但 go install 无反应
新版 Go（1.21+）默认不自动安装语言服务器，需要手动触发：
- 先确认
$GOPATH/bin在 PATH 中（否则装了也找不到） - 运行
go install golang.org/x/tools/gopls@latest - 如果提示
no required module provides package，就在任意空目录下先执行go mod init tmp再重试
装完后重启 VS Code，不要点“Install All”——那个按钮在模块未初始化时容易失败。
go run main.go 输出乱码或直接退出，但没报错
常见于 Windows 的 CMD 默认编码为 GBK，而 Go 源文件是 UTF-8。临时解决不用改系统设置：
- 换用 PowerShell 或 Windows Terminal（自带 UTF-8 支持）
- 或者在 CMD 中临时切编码：
chcp 65001（即 UTF-8） - 更稳妥的做法：用 VS Code 保存
main.go时明确选 “UTF-8 with BOM” 或纯 “UTF-8”，避免编辑器悄悄插入不可见控制字符
这个细节不报错、不提示，但会导致 fmt.Println 输出异常，尤其含中文时。
go version、能建模块、能跑 go run、能进编辑器调试。其他工具（如 dlv、staticcheck）按需再装，别一上来就堆插件。真正容易被忽略的，是 shell 环境变量加载时机和 Windows 编码隐性冲突——这两个点卡住，比装错版本还难排查。 
