go命令能运行≠vscode可开发，必须验证goproxy、go111module和gopls三者对齐：设goproxy=https://goproxy.cn,direct、go111module=on，并手动安装gopls@latest后配置路径。
go 命令能直接运行，说明安装和基础环境已通；但 VSCode 里写 main.go 报红、gopls 启动失败、go get 超时——这些不是“没装好”，而是代理、模块、工具链三者没对齐。国内环境下，跳过任一环节都会卡在编辑器里动不了。
验证 go 是否真可用，别只看 go version
仅执行 go version 成功，不代表开发环境就绪。必须确认三件事：
-
go env GOPROXY输出包含https://goproxy.cn或https://proxy.golang.com.cn（2026年主流镜像），不能是空或https://proxy.golang.org -
go env GO111MODULE必须是on，不是auto或off；新版 Go 默认on，但旧终端可能缓存旧值，需重启终端再查 - 执行
go list -m -f '{{.Dir}}' std，应快速返回标准库路径（如/usr/local/go/src）；若卡住或报错，说明GOROOT损坏或被覆盖
VSCode 插件装了，但 gopls 一直 “Initializing”
这是国内用户最常卡住的点：Go 官方插件会自动下载 gopls，但它默认走官方源，99% 失败。
- 不要等插件自动装——手动在终端执行：
go install golang.org/x/tools/gopls@latest - 装完后，在 VSCode 设置里搜
go.gopls.path，填入gopls的绝对路径（Windows 可用where gopls，macOS/Linux 用which gopls） - 如果仍卡住，关掉 VSCode，删掉
~/.cache/go-build和$GOPATH/pkg/mod/cache/download，再重开 - 注意：
gopls版本必须与当前go版本兼容（例如go 1.25应配gopls v0.15+；查版本用gopls version）
go run main.go 成功，但 go build 报 cannot find module
这不是路径问题，是模块初始化缺失。Go 1.16+ 默认启用 Modules，但新建空文件夹不会自动生成 go.mod。
- 进项目根目录，运行
go mod init example.com/myapp（域名随意，只是模块标识） - 如果已有
go.mod却报错，检查是否在子目录里执行了go build——必须在含go.mod的目录下运行 -
go build不会自动拉依赖，而go run会；所以go build前务必先go mod tidy确保依赖落地 - 别把项目建在
%USERPROFILE%\go\src下（旧 GOPATH 风格），现代 Go 项目可放任意位置，只要顶层有go.mod
Mac M系列芯片上 go 工具链莫名崩溃
不是 ARM 兼容问题，而是 Rosetta 或 Xcode 命令行工具未就位。
- 先运行
xcode-select --install，确保命令行工具存在；若提示已安装，执行xcode-select --reset - M芯片用户避免混用 Intel 和 ARM 版 Go：下载时认准
darwin-arm64.pkg，别用darwin-amd64.pkg（即使能装，cgo相关操作大概率失败） - 如果 VSCode 终端里
go正常，但调试器启动失败，检查 VSCode 是否运行在 Rosetta 模式下（右键 VSCode → 显示简介 → 勾选“使用 Rosetta”）——应取消勾选 -
CGO_ENABLED=0 go build可绕过 cgo，但会丢失 sqlite、openssl 等依赖；真正解法是重装 Xcode 命令行工具 + 用原生 arm64 Go
go 命令通了，不等于 gopls 能用，也不等于模块能构建，更不等于 Mac 上调试器能跑。每一步都要用具体命令验证，而不是靠界面状态猜。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
