go version报command not found的唯一原因是path未正确配置，需确认go二进制存在（如/usr/local/go/bin/go）、path包含该路径且已生效（echo $path验证），并重启终端或source配置文件。
go version 命令报 command not found 怎么办
PATH 没配对是唯一原因，不是权限、版本或网络问题。
- 先确认
go二进制是否真在磁盘上：运行ls /usr/local/go/bin/go（Linux/macOS）或dir "C:\Go\bin\go.exe"（Windows），如果文件不存在，说明解压失败或路径选错了 - 检查 shell 配置文件是否生效：用
echo $PATH看输出里有没有/usr/local/go/bin或C:\Go\bin；没出现就说明export PATH=...没加载，常见于改了~/.zshrc却没执行source ~/.zshrc，或终端没重启 - WSL2 用户注意：不要把 Go 解压到 Windows 文件系统（如
/mnt/c/...），否则go run可能因权限或符号链接异常失败；应解压到 Linux 根文件系统下（如/usr/local）
go mod init 后 go run 还是找不到包
根本不是依赖没下载，而是当前目录不在模块根路径下，go 命令压根没识别到 go.mod。
- 运行
go env GOMOD，如果输出空字符串，说明当前工作目录未被识别为模块——go会退回到 GOPATH 模式，而你大概率没设 GOPATH - 确保你在
go.mod所在目录（即go mod init执行的目录）下运行go run main.go；不要 cd 进子目录再跑 - VS Code 中打开的文件夹必须是模块根目录（含
go.mod），否则gopls自动降级，补全失效、跳转报错都由此引发
VS Code 调试断点不命中
90% 是 dlv 没装对，或 launch.json 配置绕过了调试器。
- 手动验证
dlv是否可用：运行dlv version，输出应类似Delve Debugger Version: 1.22.0；若报 command not found，执行go install github.com/go-delve/delve/cmd/dlv@latest - 检查
.vscode/launch.json中program字段是否指向./main.go（推荐）而非已编译的二进制；指向二进制时，断点位置信息可能丢失 - 确保
dlvLoadConfig设置合理：尤其followPointers和maxVariableRecurse影响变量展开深度，但不影响断点命中；真正关键的是mode必须为exec或auto，不能写成core或留空
Docker 容器里 go mod download 失败
官方 golang:1.22 镜像默认不含 HTTPS 根证书和 git，不是代理或网络问题。
- 直接运行
docker run --rm golang:1.22 sh -c "go mod download"就会复现：错误通常是x509: certificate signed by unknown authority或exec: "git": executable file not found in $PATH - Dockerfile 必须显式安装基础依赖：Debian 系用
apt-get update && apt-get install -y ca-certificates git；Alpine 系用apk add --no-cache ca-certificates git - 别忽略
VOLUME ["/go/pkg/mod"]：不挂载模块缓存，每次docker build或docker run都重下所有依赖，浪费时间且易触发限流
go env 和 which 一层层查。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
