go version找不到或版本不对是shell未正确加载go二进制，需检查PATH是否含%GOROOT%\bin（Windows）或/usr/local/go/bin（macOS/Linux），改后必须重启终端并用where go或which go验证路径。
go version 找不到或版本不对
不是 Go 没装，是 shell 拿不到正确的 go 二进制。迁移后最常卡在这一步，尤其从旧机器复制配置、或重装系统后 PATH 没刷新。
- Windows：检查系统环境变量
Path是否包含%GOROOT%\bin（不是%GOROOT%），且确认%GOROOT%指向新安装路径（如C:\Go）；改完必须重启所有 CMD/PowerShell 窗口 - macOS/Linux：确认
~/.zshrc或~/.bash_profile里有类似export PATH=$PATH:/usr/local/go/bin的行，且路径与实际GOROOT一致；改完必须运行source ~/.zshrc - 验证方式：执行
which go（macOS/Linux）或where go（Windows），输出应为新安装路径下的bin/go；若指向/usr/bin/go，说明系统旧版优先级更高，需从 PATH 中移除或调整顺序
go mod init 或 go build 报 “cannot find module”
这不是代码问题，是模块代理或路径解析失效。迁移后 GOPROXY 常被重置为默认值，或项目路径含中文/空格导致解析失败。
- 先检查代理：运行
go env GOPROXY，国内环境必须为类似https://goproxy.cn,direct；若为空或为https://proxy.golang.org，立即执行go env -w GOPROXY=https://goproxy.cn,direct - 项目路径不能含中文、空格、括号、emoji；推荐用纯 ASCII 路径，如
/home/user/myapp或D:\go\myapp - 初始化前确保在项目根目录下执行
go mod init example.com/myapp（模块名不用真实存在，但须符合导入路径格式，避免大写字母） - 如果已有
go.mod但内容异常，直接删掉重建比修复更可靠
VS Code 提示 “gopls not found” 或调试器启动失败
新版 Go（1.21+）不自动安装语言服务器，且 VS Code 不继承系统 PATH 变量，容易误判工具缺失。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先确认
$GOPATH/bin已加入 PATH（运行echo $PATH或echo %PATH%查看），否则go install装的命令找不到 - 手动安装：在空目录下先执行
go mod init tmp，再运行go install golang.org/x/tools/gopls@latest - Delve 同理：
go install github.com/go-delve/delve/cmd/dlv@latest - 装完必须重启 VS Code 全部窗口（不只是重新加载窗口），状态栏右下角应显示
gopls (v0.15.x)，不是loading或报错
go run 输出乱码或静默退出
尤其 Windows 用户迁移后易踩此坑：CMD 默认编码仍是 GBK，而 Go 源文件是 UTF-8，不报错但中文输出异常。
立即学习“go语言免费学习笔记（深入）”；
- 临时解决：在 CMD 中运行
chcp 65001切换为 UTF-8 编码 - 长期建议：改用 PowerShell 或 Windows Terminal（默认 UTF-8 支持）
- VS Code 保存文件时选 “UTF-8” 编码（不要带 BOM），避免编辑器插入不可见控制字符干扰
fmt.Println - 注意：这个错误不会触发 panic 或编译失败，但会导致日志、提示、HTTP 响应体等含中文内容完全不可读
go run 输出问号、让 gopls 卡在 loading、让依赖永远拉不下来。 
