根本原因是PATH未包含Go的bin目录；macOS/Linux需在~/.zshrc或~/.bash_profile中添加export PATH=$PATH:/usr/local/go/bin并source生效，Windows需在系统环境变量PATH中新增C:\Go\bin并重启终端验证。
Go 安装后 go version 报错：command not found
常见于 macOS 或 Linux 下用二进制包手动解压安装，或 Windows 下未勾选「Add to PATH」。根本原因是系统找不到 go 可执行文件。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认安装路径，比如 macOS 解压到
/usr/local/go，Windows 默认在C:\Program Files\Go - 把
bin子目录加进 PATH：
– macOS/Linux：在~/.zshrc或~/.bash_profile末尾加export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc
– Windows：通过「系统属性 → 高级 → 环境变量」编辑用户或系统 PATH，新增C:\Program Files\Go\bin - 重启终端（不是仅新开窗口），再执行
go version验证
为什么 go mod init 后 go run main.go 仍报 cannot find module providing package
这是模块路径和当前工作目录不匹配导致的典型错误，尤其新手常忽略 go mod init 的参数含义。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
-
go mod init后面必须跟一个模块路径（如go mod init example.com/hello），它不一定是真实域名，但必须唯一且不能是空字符串 - 确保你在模块根目录下运行
go run—— 即包含go.mod文件的目录，而不是子文件夹 - 如果已误操作，删掉当前目录下的
go.mod和go.sum，重新go mod init xxx - Windows 下路径含空格（如
C:\Users\My Name\code）也可能触发类似问题，建议开发目录用纯英文无空格路径
VS Code 中 Go 扩展提示 Failed to install dlv 或调试器无法启动
本质是 dlv（Delve）调试器未正确安装或版本与 Go 不兼容，常见于 Go 1.21+ 和旧版 Delve 冲突。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先运行
go install github.com/go-delve/delve/cmd/dlv@latest手动安装最新版dlv - 检查安装结果：
which dlv（macOS/Linux）或where dlv（Windows），确认输出路径在 PATH 中 - VS Code 设置里搜索
go.delvePath，手动填入上面查到的完整路径（如/home/xxx/go/bin/dlv） - 若用 Apple Silicon Mac，避免用 Homebrew 安装
dlv—— 它可能编译为 x86 架构，导致运行失败；务必用go install方式
Windows 上 go get 超时或模块拉取失败
国内直连 golang.org / github.com 常因网络策略失败，但直接配代理容易引发 GOPROXY 冲突或证书错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先设官方镜像代理：
go env -w GOPROXY=https://proxy.golang.org,direct（全球可用）或国内推荐https://goproxy.cn - 禁用私有仓库校验（仅本地开发）：
go env -w GONOPROXY=（留空）或填公司内网域名，避免误拦 - 不要混用
GO111MODULE=on和GOINSECURE—— 后者只对非 HTTPS 私库有效，对超时问题无效 - 如果仍失败，临时关防火墙/杀软测试；某些国产安全软件会劫持 go 命令的 HTTPS 连接
dlv 架构匹配、代理链路层级这些点，不报错时几乎不显形，一出问题却很难快速定位。建议初始化项目前，先跑通 go mod init + go run + dlv debug 三步最小闭环。 
