go命令找不到的首要原因是PATH未包含Go的bin目录，需确认安装路径（如/usr/local/go/bin或C:\Go\bin）并将其添加到系统PATH，再重载配置或重启终端验证。
go命令找不到？先查PATH和安装路径
最常见的情况是安装完Go，终端敲go version直接报command not found。这不是Go没装好，而是系统根本没找到它。
Windows默认装在C:\Program Files\Go\bin，macOS用Homebrew装在/opt/homebrew/bin或/usr/local/bin，Linux手动解压的通常在/usr/local/go/bin。这些路径必须显式加进PATH，系统才认得go命令。
- macOS/Linux：检查
~/.zshrc或~/.bash_profile里有没有export PATH=$PATH:/usr/local/go/bin（路径按你实际安装位置改） - Windows：右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”里找到
Path，新增一行填C:\Program Files\Go\bin - 改完别忘了重新打开终端，或运行
source ~/.zshrc（macOS/Linux）
CGO_ENABLED=1但还是编译失败？检查MinGW或MSVC工具链
只要代码里有// #include <stdio.h>这类C头文件引用，或者用了cgo标记，就必须有C编译器。Windows上没有GCC，得靠MinGW或MSVC。
MinGW选错版本会直接卡死：x86_64-w64-mingw32-gcc和x86_64-ucrt-gcc不兼容。Win10+推荐用UCRT版，解压后把bin目录加进PATH，再验证gcc -v能输出版本信息。
立即学习“go语言免费学习笔记（深入）”；
- 如果用MSVC，确保已安装“Desktop development with C++”工作负载（Visual Studio Installer里勾选）
- 临时禁用CGO调试：设
CGO_ENABLED=0，看是否纯Go部分能跑通——能通说明问题出在C工具链 - Go 1.22+对UCRT支持更稳，旧版Go可能需要额外配
CC环境变量指向gcc.exe绝对路径
go mod tidy总失败？重点盯住GOPROXY和go.sum
go mod tidy卡住或报missing go.sum entry，90%是因为模块代理不可达，或本地go.sum校验失败。
国内直连proxy.golang.org基本超时，必须换代理。但别只设GOPROXY，还得加direct兜底，否则私有模块拉不到：
- 运行
go env -w GOPROXY=https://goproxy.cn,direct - 删掉项目根目录下的
go.sum，再跑go mod tidy——Go会重新生成校验和 - 如果公司用私有仓库，要在
GOPRIVATE里声明域名，例如go env -w GOPRIVATE=git.internal.company.com
VSCode里Go插件不生效？别跳过go.toolsGopath配置
装完官方Go插件，Ctrl+Click点不到函数定义、没自动补全，大概率是插件没找对Go工具链位置。
VSCode的Go插件默认用go命令所在路径推导工具集位置，但gopls、dlv等二进制未必在同一目录。尤其当你用g工具管理多版本Go时，插件可能还在用旧版本的gopls。
- 在VSCode设置里搜
go.toolsGopath，设为$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows） - 打开命令面板（
Cmd+Shift+P），运行Go: Install/Update Tools，全选并安装——这会把gopls等工具装到go.toolsGopath指定路径下 - 重启VSCode，再开项目目录，状态栏右下角应该显示
gopls (v0.x)，而不是gopls is not available
环境变量和工具链路径对不上，是绝大多数“明明装了却用不了”的根源。盯着PATH、GOPATH、GOPROXY这三个点反复验证，比重装Go有效得多。
