Go 1.21+ 安装成功需验证 go version 和 go run 均正常，关键在 PATH 生效（Windows 检查是否勾选 Add to PATH 并重启终端，macOS/Linux 执行 source 配置文件并用 which go 确认路径），go mod init 报错主因是目录名含空格或非法字符，应使用合法小写模块路径如 github.com/yourname/hello。
Go 1.21+ 版本在 Windows/macOS/Linux 上装完就能写 main.go，不用配 $GOPATH，也不用开代理——只要别卡在下载 golang.org/x/... 包这一步。
怎么验证 Go 安装成功，而不是只跑了 go version
很多人跑完 go version 就以为装好了，结果 go run main.go 报 command not found: go 或直接卡住。这是因为 PATH 没生效，或者 shell 配置没重载。
- Windows：安装时勾选 “Add to PATH”，装完重启终端；若用 PowerShell，运行
$env:PATH看是否含C:\Program Files\Go\bin - macOS（Homebrew）：装完执行
source ~/.zshrc（或~/.bash_profile），再which go应返回/opt/homebrew/bin/go或/usr/local/bin/go - Linux：检查
/usr/local/go/bin是否在$PATH中，用echo $PATH | grep go快速确认
go mod init 报错 “cannot determine module path” 怎么办
这是新手最常遇到的初始化失败，本质是当前目录名不符合模块路径规范，不是权限或网络问题。
- 不要在桌面、
Downloads或根目录下建项目——这些路径名含空格或特殊字符，go mod init会拒绝解析 - 模块名不能以
.或-开头，也不能含大写字母（如MyProject不行，myproject可以） - 推荐做法：新建
~/go/src/github.com/yourname/hello，进目录后运行go mod init github.com/yourname/hello - 如果只想快速测试，直接用
go mod init example.com/hello（任意合法域名格式都行，不真要能访问）
vscode 里点运行按钮没反应，或提示 “No debug configuration found”
VS Code 默认不带 Go 调试器，装了插件也不代表自动配置好调试环境。
立即学习“go语言免费学习笔记（深入）”；
- 必须装官方插件：
Go（由 Go Team 维护，IDgolang.go），禁用其他名字相近的第三方 Go 插件 - 首次打开
.go文件时，右下角会弹出 “Install All Tools”，点它——它会自动下载dlv（Delve）、gopls等二进制，过程可能慢，别关窗口 - 确保
settings.json里没手动禁用"go.toolsManagement.autoUpdate": true，否则工具不会自动升级 - 如果仍报错，按
Ctrl+Shift+P→ 输入Go: Install/Update Tools手动触发一次
真正麻烦的不是装软件，而是第一次 go get 失败时不知道该查日志还是换源——其实只需在项目根目录加 go env -w GOPROXY=https://goproxy.cn,direct，国内用户基本就畅通了。
