go version报“command not found”说明PATH未包含$GOROOT/bin（Linux/macOS）或%GOROOT%\bin（Windows），且GOROOT未正确定义；需验证GOROOT路径并将其bin目录加入PATH，再重启终端生效。
go version 命令没反应？先确认 GOROOT 和 PATH
输入 go version 报 “command not found” 或直接无输出，说明系统根本找不到 go 二进制文件。这不是 Go 没装好，而是环境变量没生效。
必须确保两件事同时成立：
-
GOROOT指向你解压/安装 Go 的根目录（例如/usr/local/go或D:\environment\go1.19.windows-amd64\go） -
PATH包含$GOROOT/bin（Linux/macOS）或%GOROOT%\bin（Windows）
验证方式：在终端执行 echo $GOROOT（macOS/Linux）或 echo %GOROOT%（Windows），再看 echo $PATH 是否含 bin 路径。别依赖安装向导自动配置——尤其是 Windows MSI 安装包有时会漏掉 GOROOT。
go mod init 失败提示 “unknown revision”？关掉 GOPROXY 就行
运行 go mod init example/hello 后，紧接着 go run . 报错类似 unknown revision v1.2.3 或卡在 Fetching github.com/xxx，大概率是代理问题。
立即学习“go语言免费学习笔记（深入）”；
国内用户最稳妥的临时解法是绕过代理直连：
- 执行
go env -w GOPROXY=direct - 再试
go run .—— 如果成功，说明原GOPROXY不可用或缓存异常 - 恢复代理时建议用
https://goproxy.cn,direct（注意逗号分隔），别只写一个地址
注意：GO111MODULE=on 是前提，但错误常被误判为模块问题，实际根源在代理链路断开。
想生成单个静态可执行文件？用 GOOS + CGO_ENABLED=0
默认 go build 生成的二进制在 Linux 上可能依赖 glibc，在 Alpine 或某些容器里直接报 No such file or directory。这不是编译失败，是动态链接失败。
静态编译只需两步：
- 设置
CGO_ENABLED=0：禁用 C 链接，强制纯 Go 实现（net包会回退到纯 Go DNS 解析） - 显式指定目标平台：
GOOS=linux GOARCH=amd64 go build -o myapp
常见组合：
- Linux 容器部署：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app - macOS 本地测试：
CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o app - Windows 交叉编译：
CGO_ENABLED=0 GOOS=windows GOARCH=amd64 go build -o app.exe
别省略 CGO_ENABLED=0 —— 单设 GOOS 不足以保证静态；也别信“默认就是静态”，Go 1.16+ 默认启用 cgo。
vscode 调试不进断点？检查 launch.json 的 program 字段
用 VS Code + dlv 调试时，断点灰掉、F5 直接运行无响应，大概率是 launch.json 里 program 指向了源码路径而非可执行文件。
正确写法必须是：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test",
"program": "${workspaceFolder}",
"env": {}
}
]
}
关键点：
-
program应为"${workspaceFolder}"（对应go run .行为），不是"./main.go"或硬编码路径 - 确保已安装
dlv：go install github.com/go-delve/delve/cmd/dlv@latest - 调试前先
go mod tidy，避免因依赖缺失导致 dlv 启动失败
Delve 不是黑盒——它依赖 go build 的输出结构，program 字段错一点，整个调试链就断了。
