go 1.11+ 默认启用模块，gopath已非必需；国内用户必须配置goproxy（如goproxy.cn），否则go get会卡死或超时；验证需检查go env goroot和goproxy，而非仅go version。
Go 1.11+ 默认启用模块（go mod），GOPATH 已非必需；国内用户必须配 GOPROXY，否则 go get 会卡死或超时。
验证 go version 和 go env 输出是否可信
很多新手看到 go version 有输出就以为装好了，但实际可能调用的是旧版本或 PATH 冲突的残留二进制。真正可靠的验证方式是：
- 运行
go env GOROOT，确认路径指向你刚安装的目录（如/usr/local/go或C:\Go\），而非C:\Users\xxx\go这类错误路径 - 运行
go env GOPROXY，应返回类似https://goproxy.cn,direct；若为空或https://proxy.golang.org，后续go mod download几乎必失败 - Windows 用户特别注意：MSI 安装器虽自动加
%GOROOT%\bin到 PATH，但若曾手动改过环境变量，可能被覆盖——建议在 CMD 中执行where go（不是which go）看实际调用位置
go mod init 后为什么 go run 仍报 “cannot find module”
这不是路径问题，而是模块初始化和当前工作目录不匹配导致的隐式行为。常见于：
- 你在
~/myproject下执行了go mod init example.com/foo，但文件main.go不在该目录下，而在子目录~/myproject/cmd/app/——此时go run cmd/app/main.go会失败，因为模块根不在当前目录 - 解决方法只有两个：
cd进模块根目录再运行，或显式指定模块路径：go run -modfile=go.mod cmd/app/main.go - 更隐蔽的坑：
go mod init若未指定模块名（如漏写example.com/foo），会默认用当前路径名（含非法字符如空格、中文），导致后续所有依赖解析失败，且错误信息不提示根源
VS Code 中 Go 插件反复提示 “Failed to install tools”
根本原因几乎全是网络或权限问题，不是插件本身故障。典型表现是弹窗卡在 dlv、gopls、goimports 等工具安装上：
- 先手动运行：
go install github.com/go-delve/delve/cmd/dlv@latest，观察是否因代理缺失而超时；若失败，立刻执行：go env -w GOPROXY=https://goproxy.cn,direct - macOS / Linux 用户注意：
go install默认把二进制放$GOPATH/bin，但 VS Code 可能没读到该路径 —— 建议统一设为export GOPATH=$HOME/go并确保$GOPATH/bin在 PATH 中 - Windows 上若用 PowerShell 启动 VS Code，而 PATH 是在 CMD 里配置的，会导致插件找不到
go命令 —— 推荐直接从终端启动：code .
go build 成功但二进制运行报 “no such file or directory”
这是 Linux/macOS 上最易被忽略的动态链接问题，尤其在交叉编译或使用 cgo 时：
- 运行
ldd your_binary（Linux）或otool -L your_binary（macOS），检查是否依赖系统级库（如libpthread.so.0）但宿主机缺失 - 若项目用了
cgo（比如调用 SQLite、OpenSSL），默认构建是动态链接；加CGO_ENABLED=0可强制静态链接：CGO_ENABLED=0 go build -o app main.go - macOS 上还常因 SIP（系统完整性保护）拦截对
/usr/lib的访问，此时不要硬改权限，改用go build -ldflags="-s -w"减少符号依赖即可
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
