go version报错或显示旧版本，说明环境变量未生效或PATH中存在多个go/bin路径；需重启终端、清理旧路径并验证GOROOT。
go version 命令报错或显示旧版本
安装后执行 go version 报错，或显示的是系统残留的旧版本（比如 go version go1.16.15 windows/amd64），说明新安装的 Go 没被系统识别——根本原因是环境变量未生效或被旧路径覆盖。
- Windows：必须关闭所有已打开的 CMD/PowerShell 窗口，重新打开一个终端再试；如果仍不对，检查系统环境变量
PATH中是否同时存在多个go/bin路径（例如C:\Go\bin和D:\oldgo\bin），删掉旧的 - macOS/Linux：执行
which go看实际调用的是哪个二进制文件；若返回/usr/local/bin/go但你装在/usr/local/go，大概率是之前用 Homebrew 装过，先运行brew uninstall go再重装官方包 - 验证
GOROOT是否正确：运行go env GOROOT，输出应为你的安装目录（如/usr/local/go或C:\Program Files\Go）；若为空或错误，需手动设置（但 MSI/.pkg 安装通常自动完成）
go run main.go 提示 “no required module provides package”
这是 Go Modules 启用后最典型的报错，不是代码写错了，而是项目没初始化模块上下文。Go 1.16+ 默认开启 Modules，go run 不再默认从 GOPATH/src 查找包，而是依赖 go.mod 文件定义依赖边界。
- 进入项目根目录（不是
GOPATH/src下某子目录，就是你自己新建的空文件夹），运行go mod init example.com/hello（模块名可任意，不需真实域名） - 执行后会生成
go.mod文件，内容类似：module example.com/hello<br>go 1.22
- 此时再运行
go run main.go就能成功；若main.go里用了第三方包（如github.com/gin-gonic/gin），首次运行时 Go 会自动下载并写入go.mod和go.sum - 注意：不要在
GOPATH/src里硬套旧工作区结构——Modules 模式下，项目可放在任意路径，GOPATH仅用于存放go install的可执行文件（即$GOPATH/bin）
go build 编译出的二进制文件无法运行或提示 missing DLL
Windows 上编译出的可执行文件双击闪退，或命令行报 The program can't start because VCRUNTIME140.dll is missing，本质是 Go 默认使用 CGO（C 语言互操作），而某些标准库（如 net）在 Windows 上依赖 VC++ 运行时。
- 最简单解法：禁用 CGO 编译，用纯 Go 实现替代，命令是
CGO_ENABLED=0 go build -o hello.exe（Linux/macOS）或set CGO_ENABLED=0 && go build -o hello.exe（Windows CMD） - 若项目确实需要 CGO（比如调用 C 库），则需安装 Visual Studio Build Tools 或完整 VS，并确保
vcvarsall.bat已加载；但绝大多数 Web/API 服务无需它 - 交叉编译要注意：
GOOS=linux GOARCH=amd64 go build时，CGO_ENABLED默认为 0，所以跨平台编译天然更干净；本地开发建议统一设为 0 避坑
VSCode 里没有代码提示或跳转失效
装了 Go 插件但 fmt.Println 不高亮、Ctrl+Click 跳不到定义，问题不在插件本身，而在底层工具链缺失或代理失败。
立即学习“go语言免费学习笔记（深入）”；
- 先确认 VSCode 终端里执行
go env GOPROXY返回的是https://goproxy.cn,direct—— 如果是空或https://proxy.golang.org，说明代理没配，插件下载gopls（Go 语言服务器）会超时失败 - 手动触发工具安装：在 VSCode 命令面板（
Ctrl+Shift+P）输入Go: Install/Update Tools，全选并安装；若卡在gopls，关掉 VSCode，CMD 执行go install golang.org/x/tools/gopls@latest（前提是代理已配好） - 检查 VSCode 设置里是否启用了
"go.useLanguageServer": true（新版插件默认开启）；若误关了，提示会退化成基础语法检查，无智能补全 - 项目根目录下必须有
go.mod，否则gopls无法识别模块边界，整个项目视为“无模块”，提示范围受限
go env 输出里的 GOPATH、GOPROXY、GOROOT 三个值，再确认项目根目录有 go.mod，90% 的搭建问题就定位完了。 
