go version报错说明PATH未生效，非安装失败：Windows需检查系统环境变量中%GOROOT%\bin是否添加且路径存在；macOS/Linux需确认shell类型并编辑对应配置文件（如~/.zshrc），追加export PATH=$PATH:/usr/local/go/bin后source生效。
go version 命令报错或不识别
说明 go 命令根本没进系统 PATH，不是安装失败，而是路径没生效。Windows 上常见于手动改了安装路径却没更新 Path；macOS/Linux 则多因 shell 配置文件选错（比如改了 ~/.zshrc 却用的是 bash，或改完没 source）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Windows：打开「系统属性 → 高级 → 环境变量」，确认
Path里包含%GOROOT%\bin（如C:\Go\bin），且该路径真实存在 - macOS/Linux：运行
echo $SHELL看当前 shell，再编辑对应配置文件（~/.zshrc或~/.bash_profile），追加export PATH=$PATH:/usr/local/go/bin，然后执行source ~/.zshrc - 验证是否加载成功：新开一个终端窗口再试
go version，不要复用旧窗口
go env 显示 GOPATH 是 ~/go，但我想放 D:\mygo
新版 Go（1.11+）默认启用 modules，GOPATH 不再影响依赖存放位置，但它仍控制 go install 生成的二进制文件落点（即 $GOPATH/bin）。如果你习惯把项目和工具集中管理，改它是合理的。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Windows：用命令
go env -w GOPATH=D:\mygo（注意反斜杠不用转义） - macOS/Linux：用
go env -w GOPATH=/Users/yourname/mygo - 改完立刻生效，无需重启终端；但已有项目若依赖旧
GOPATH/src结构，需手动迁移目录 - 不推荐设为根目录（如
D:\）或含空格/中文路径，容易触发构建工具异常
go mod init 后 go build 报错“cannot find module providing package”
这不是环境问题，而是模块初始化后未正确声明导入路径或依赖未下载。常见于复制粘贴代码时漏掉 import，或 go.mod 里写的 module 名与实际 import 路径不一致（比如写成 example.com/hello，代码里却 import "github.com/xxx/yyy"）。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查
go.mod第一行module声明是否匹配你代码中所有import的前缀 - 运行
go mod tidy自动补全缺失依赖、清理未用项 - 如果用了私有仓库或国内镜像，确认
GO111MODULE=on且GOPROXY已设（如https://goproxy.cn） - 别手动编辑
go.sum—— 它由go mod系统自动生成校验，删了会触发重新计算
VSCode 里写 Go 代码没提示、调试器启动失败
本质是 VSCode 的 Go 扩展没连上本地 go 工具链，或者扩展依赖的辅助工具（如 dlv、gopls）没装全。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先在终端跑
go install github.com/go-delve/dlv/cmd/dlv@latest和go install golang.org/x/tools/gopls@latest - VSCode 设置里搜
go.gopath，值设为空（新版推荐留空，让插件自动探测）；搜go.toolsEnvVars，确保GOPROXY和GO111MODULE正确 - 重启 VSCode 后，打开一个
.go文件，看状态栏左下角是否显示Go和gopls版本号；没出现就点右下角提示“Install All Tools” - 调试前确认
launch.json里"mode": "auto"，不要硬写"exec"或"test"——除非你真在调试已编译好的二进制
which go（macOS/Linux）或 where go（Windows），比盲目重装更省时间。 
