go version报错或显示旧版本说明PATH指向旧安装；go run/build提示import对象版本不匹配说明GOROOT与编译器版本不一致；go mod download失败多因GOPROXY未配置；VS Code提示dlv not found需手动安装并确保GOBIN或GOPATH/bin加入PATH。
go version 命令报错或显示旧版本
说明：执行 go version 时提示“不是内部或外部命令”，或输出一个明显过时的版本（如 go1.12），大概率是 PATH 指向了残留的旧安装，而非当前安装的 Go。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在命令行运行
where go（Windows）或which go（macOS/Linux），确认系统实际调用的是哪个go.exe或go二进制文件 - 检查该路径是否与你新安装的 Go 目录一致（如
C:\Go\bin\go.exe或/usr/local/go/bin/go）；若指向C:\Users\XXX\go\bin\go.exe等非标准位置，说明有旧版残留或误配 - 打开环境变量编辑界面，删掉所有指向旧 Go 安装路径的
PATH条目，只保留唯一、正确的bin路径 - 重启终端（不是仅关掉窗口，要彻底新建一个 cmd/PowerShell/Terminal），再试
go version
go run / go build 提示 “import C:/go/pkg/...: object is [xxx] expected [yyy]”
说明：这是典型的 GOROOT 与编译器不匹配错误。比如 go.exe 是 1.22 版本，但 GOROOT 指向了 1.20 安装目录下的 pkg，导致标准库 .a 文件版本对不上。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env GOROOT，确认输出路径是否和你当前go可执行文件所在目录一致（例如C:\Go） - 如果
GOROOT是手动设置的，且值为C:\Users\XXX\go或其他非安装根目录，请立即清空该变量（Go 1.16+ 后官方推荐不设GOROOT，让go自动推导） - 不要把
GOROOT和GOPATH搞混：GOROOT是 Go 安装根目录（含src、pkg、bin），GOPATH是你的工作区（放src、bin、pkg的用户目录） - 删掉
GOROOT环境变量后，重启终端，再运行go env看GOROOT是否自动变为正确路径
go mod download 报错 “cannot find module providing package” 或超时卡住
说明：模块下载失败通常不是网络连通性问题，而是代理配置缺失或无效，尤其在国内访问 golang.org/x 等路径时会直接 404。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或https://proxy.golang.org,direct（海外稳定） - 确认
GO111MODULE已启用：go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧终端可能缓存旧值） - 避免在项目外执行
go mod download—— 必须在含go.mod的目录下运行，否则会报“no go.mod file found” - 临时验证代理是否生效：执行
curl -v https://goproxy.cn/github.com/golang/freetype/@v/v0.0.0-20170609003504-e23677dcdc83.info，看能否返回 JSON
VS Code 中 Go 扩展提示 “dlv not found” 或调试启动失败
说明：VS Code 的 Go 扩展依赖 dlv（Delve 调试器）二进制，但它不会自动安装，需手动获取并确保 PATH 可见。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在终端中运行
go install github.com/go-delve/delve/cmd/dlv@latest（注意：不是go get，后者已弃用） - 安装完成后，运行
dlv version验证是否可用；若提示“command not found”，说明GOBIN或GOPATH/bin未加入PATH - 检查
go env GOPATH和go env GOBIN，通常dlv会被装到$GOPATH/bin/dlv；把该路径加进系统PATH，然后重启 VS Code - 不要在管理员权限的 PowerShell/CMD 中安装
dlv后，又用普通权限的 VS Code 启动 —— 权限上下文不一致会导致找不到
source 或刷新配置。Windows 尤其明显——PATH 修改后，旧 cmd 窗口里的进程不会重新读取系统变量。 
