go环境配置需重点设goroot和goproxy，go mod init须在项目根目录执行且避开$gopath/src，模块路径须唯一可解析，初始化后必须运行go mod tidy补全依赖，代理推荐阿里云镜像加direct兜底。
Go 环境现在基本不用手动配 GOPATH，但 GOROOT 和代理设置稍有不慎就会卡在 go mod download 或 go get 上。装完 go version 能跑，不代表开发能跑通。
go version 能输出 ≠ go mod 能工作
很多新手看到 go version 返回成功就以为万事大吉，结果一建项目执行 go mod init 就卡住，或者 go run 报 cannot find module providing package fmt —— 这说明 Go 没识别到模块根目录，或模块初始化失败。
-
go mod init必须在项目根目录下执行，且该目录不能是$GOPATH/src下的子路径（旧模式残留） - 如果当前目录已有
go.mod，再执行go mod init会报错，不是覆盖而是拒绝重初始化 - Windows 用户常见坑：路径含中文或空格（如
C:\Users\张三\go\src\demo），会导致go mod解析失败，建议用纯英文路径 - 验证是否真正进入模块模式：运行
go env GOMOD，返回非空路径（如D:\demo\go.mod）才算生效
go proxy 必须设，否则依赖拉不下来
国内直连 proxy.golang.org 基本不可用，go get 或 go mod tidy 会超时或 403。这不是网络问题，是 Go 默认代理策略导致的。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 推荐设置：执行
go env -w GOPROXY=https://mirrors.aliyun.com/golang/,https://proxy.golang.org,direct - 不要只设一个代理——
direct是兜底项，放在最后，否则私有模块无法拉取 - 若公司有内网镜像，可替换阿里云地址，但必须保留
,direct结尾 - 验证代理生效：执行
go env GOPROXY，输出应含你刚设的 URL，且无引号包裹
VSCode 插件不认 go，多半是 GOPATH 或工具路径没对齐
装了官方 Go 插件（ms-vscode.go），但代码没提示、Ctrl+Click 进不去源码、调试器启动失败——大概率是插件找不到 gopls 或本地 Go 工具链。
- 先确认
gopls是否存在：运行which gopls（macOS/Linux）或where gopls（Windows），没有就执行go install golang.org/x/tools/gopls@latest - VSCode 设置里搜
go.gopath，**新版已弃用**，别填；改查go.toolsGopath，填空即可（现代模式不需要） - 关键配置项是
go.goroot：如果值为空，插件会自己猜；但如果系统装了多个 Go 版本（比如通过asdf或gvm），就得手动指定，比如/usr/local/go或C:\Go - 重启 VSCode 后看左下角状态栏，出现
Go (gopls)且无黄色警告图标，才算连通
go build 编译失败却没报错？检查 CGO_ENABLED
某些场景下 go build 静默失败，终端没输出、也没生成二进制文件，尤其在交叉编译或调用 C 代码时。
- 默认
CGO_ENABLED=1，但 Windows 上 MinGW 环境缺失、macOS 上 Xcode 命令行工具未装，都会让构建中断却不报错 - 临时关闭 cgo：执行
CGO_ENABLED=0 go build -o app main.go（Linux/macOS）或set CGO_ENABLED=0 && go build -o app.exe main.go（Windows CMD） - 若关闭后能成功，说明问题出在 C 工具链；若仍失败，再查
GOOS/GOARCH是否误设（比如GOOS=linux却在 Windows 上构建） -
go env输出里重点看CC和CXX两项，为空或路径不存在就是隐患
最常被跳过的其实是 go env -w 的持久化行为——它写入的是用户级配置，但某些 IDE 或 CI 环境读的是系统级或 shell 启动时的环境变量，所以改完一定要新开终端验证，而不是在当前窗口反复试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
