go version验证失败主因是path未生效，需重启终端或source配置文件；go mod init无需gopath；依赖超时需配置goproxy=https://goproxy.cn,direct；vs code调试需安装dlv且无需gopath。
go version 验证失败：不是“没装好”，而是 PATH 没生效
执行 go version 报错 command not found 或 'go' is not recognized，90% 不是安装失败，而是 shell 没读到新 PATH。Windows 上 .msi 安装器默认写入系统环境变量，但 PowerShell / CMD 启动时不会自动继承变更——必须新开终端；macOS/Linux 用 brew install go 或解压 tar.gz 后，PATH 要手动加进 ~/.zshrc 或 ~/.bash_profile，且 source 后才生效。
- Windows 用户：关掉所有 PowerShell/CMD 窗口，重新打开一个，再试
go version - macOS/Linux 用户：确认是否执行过
source ~/.zshrc（zsh 默认）或source ~/.bash_profile（bash） - 别信“安装完就能用”——哪怕安装器勾选了“Add to PATH”，也要重启终端
go mod init 失败：当前目录不在 GOPATH/src 下？现在不用管它
老教程总强调“代码必须放在 $GOPATH/src 下”，这是 Go 1.11 之前的事。2026 年起，go mod 是默认模式，go mod init 可在任意目录运行，只要该目录为空或不含 go.mod。报错 go: modules disabled by GO111MODULE=off，说明模块被手动关了。
- 检查
GO111MODULE：运行go env GO111MODULE，预期输出on - 如果输出
off，执行go env -w GO111MODULE=on -
go mod init myproject生成的go.mod文件里，模块路径（如github.com/you/myproject）只是逻辑标识，不强制对应真实路径 - 别再新建
$HOME/go/src/xxx目录结构——那是历史包袱
依赖拉取超时或 404：国内用户必须配代理，但别硬写 GOPROXY
go get 或 go mod tidy 卡住、报 timeout 或 404 Not Found，本质是 go proxy 默认指向 proxy.golang.org，国内直连不稳定。但直接设 GOProxy=https://goproxy.cn 有坑：部分私有模块或企业内网仓库无法穿透。
- 推荐配置：
go env -w GOPROXY=https://goproxy.cn,direct -
direct表示对匹配replace或exclude规则的模块走直连，避免私有库被代理拦截 - 若公司有内部 proxy（如 Nexus），可设为
GOProxy=http://nexus.example.com/repository/goproxy/,direct - 临时关闭代理调试：执行
go env -w GOPROXY=off，但仅限局域网能直连 golang.org 的场景
VS Code 调试器启动失败：launch.json 里没指定 GOPATH？现在不需要
VS Code 安装 Go 扩展后，点 ▶️ 运行 main.go 报错 Failed to launch: could not find module 或 exec: "dlv": executable file not found，和 GOPATH 无关，是调试器依赖缺失或配置错位。
- 先确保
dlv已安装：在终端执行go install github.com/go-delve/delve/cmd/dlv@latest - 检查 VS Code 是否识别到
dlv：打开命令面板（Ctrl+Shift+P），输入 “Go: Install/Update Tools”，勾选dlv并安装 -
launch.json中不要写"env": {"GOPATH": "..."}——现代 Go 项目靠go.mod定位模块，硬塞 GOPATH 反而干扰 - 最简配置只需：
"program": "${workspaceFolder}/main.go"，其余字段可删
go env -w 写错变量名、某次终端没重启、某次 proxy 配成单地址没加 ,direct——这些细节不显眼，但会让 go run 停在 0.1 秒前。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
