答案是PATH未配置导致系统找不到go命令；需确认Go安装路径，macOS/Linux在~/.zshrc或~/.bash_profile中添加export PATH=$PATH:/usr/local/go/bin并source，Windows则在系统环境变量Path中新增C:\Go\bin。
go version 命令报错：command not found 怎么办
说明 Go 二进制没进 PATH，不是没装，而是系统找不到它。
Windows 用户装完 .msi 一般自动配置好；macOS 装 .pkg 同理。Linux 和手动解压用户最容易卡在这步。
- 先确认 Go 是否真解压到了目标路径（比如
/usr/local/go），用ls /usr/local/go/bin/go看文件是否存在 - 再检查 shell 配置文件（
~/.zshrc或~/.bashrc）是否加了这行：export PATH=$PATH:/usr/local/go/bin - 改完必须执行
source ~/.zshrc（或对应文件），新开终端不会自动继承旧终端的PATH - 统信 UOS 或某些国产 Linux 发行版可能默认用
dash而非bash，此时改~/.profile更稳妥
go mod init 后 go get 一直卡住或超时
本质是模块代理不可达，默认的 https://proxy.golang.org 在国内无法直连。
别等它自己重试，直接设国内镜像：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐，稳定且同步及时） - 如果公司内网有私有代理，可换成
https://your-proxy.example.com，并确保direct保留在末尾 -
direct的作用是：当所有代理都返回 404 时，回源到 GitHub/GitLab 等原始地址拉取——不是“绕过代理”，而是兜底机制 - 验证是否生效：
go env GOPROXY应输出你刚设置的值
VS Code 提示 “Missing tools: gopls, dlv…” 怎么装
VS Code 的 Go 扩展依赖一组命令行工具，但自动安装常因网络失败静默中断。
手动装更可控，且能明确看到报错位置：
- 优先用
go install（Go 1.16+ 默认方式），不是go get：go install golang.org/x/tools/gopls@latest - 调试器必须装：
go install github.com/go-delve/delve/cmd/dlv@latest - 如果提示 “no required module provides package”，说明当前目录不在模块根下，cd 到含
go.mod的项目根再执行 - 装完后重启 VS Code，或按
Ctrl+Shift+P→ 输入Go: Restart Language Server
go run main.go 报错 “cannot find module providing package …”
这不是代码写错了，是 Go 不知道该从哪找依赖——根本原因是没启用模块模式，或模块初始化不完整。
现代 Go（1.16+）默认强制启用模块，但老项目或空目录容易漏掉关键一步：
- 确保项目根目录下有
go.mod文件，没有就运行：go mod init example.com/myapp（模块名可以是任意合法域名，不一定要真实存在） - 如果已有
go.mod但依赖没下载，运行：go mod tidy—— 它会解析 import、补全 require、删掉未用的依赖 - 不要手动编辑
go.mod添加依赖，go get或go mod tidy才是唯一可信来源 - 注意：
go run .和go run main.go行为不同，前者会扫描整个模块，后者只编译单个文件，可能导致 import 路径解析失败
真正容易被忽略的是：GO111MODULE 环境变量在某些旧 shell 配置里可能被显式设为 off，哪怕你装的是 Go 1.23 也会退化成 GOPATH 模式。执行 go env GO111MODULE 确认输出是 on，否则立刻 go env -w GO111MODULE=on。
