90%的Go新手一次配通只需四步：一是验证go环境变量顺序（which go→go version→go env GOROOT→go env GOPATH）；二是go mod init前确保有.go文件或指定完整模块名；三是用goproxy.cn替换默认代理解决go get超时；四是手动安装gopls@latest并统一VS Code终端shell环境。
不用“制定计划”——直接按这四步走，90% 的 Go 新手能一次配通。
go version 能跑，但 go env 报错或路径不对
这是最常见卡点：命令行能识别 go，但 go env 显示 GOROOT 为空或 GOPATH 指向错误目录。根本原因是安装后 PATH 没生效，或手动配置时漏了 $GOROOT/bin。
- Linux/macOS：检查
~/.bashrc或~/.zshrc是否真写了export PATH=$PATH:$GOROOT/bin，然后必须执行source ~/.zshrc（别只改完就关终端） - Windows：用 PowerShell 运行
go env，而不是旧版 CMD —— 某些 MSI 安装器只更新了 PowerShell 的环境变量 - 验证顺序必须是：
which go→go version→go env GOROOT→go env GOPATH，缺一不可
go mod init 失败，提示 “no Go files in directory”
这不是环境问题，是项目初始化姿势错了。Go Modules 不依赖 GOPATH，但要求目录里至少有一个 .go 文件，或明确指定模块名。
- 新建空目录后，先写一个
main.go（哪怕只有package main），再运行go mod init example.com/hello - 如果只想初始化不写代码，用
go mod init example.com/hello加完整域名前缀，不能只写go mod init hello - 注意当前 shell 工作目录是否真在项目根下 ——
go mod命令对路径极其敏感
go get 安装工具总超时或 403
从 2026 年起，官方代理 https://proxy.golang.org 对国内多数网络已不可靠。硬等或换源是唯一解法。
立即学习“go语言免费学习笔记（深入）”；
- 立即执行：
go env -w GOPROXY=https://goproxy.cn,direct（国内稳定镜像） - 如果公司内网有私有代理，替换为类似
https://repo.yyrd.com/artifactory/aliyun-golang/的地址 - 禁用代理仅用于调试：
go env -w GOPROXY=direct，但绝大多数情况不推荐 - 安装
gopls等工具时，务必加@latest，例如：go install golang.org/x/tools/gopls@latest，否则可能拉旧版失败
VS Code 提示 “Go extension failed to install tools”
插件自动安装失败，本质是它调用了 go install，而你没配好代理或没开 GOPROXY。
- 不要点插件弹窗里的 “Install All”，先手动在终端运行：
go install golang.org/x/tools/gopls@latest - 确保 VS Code 终端使用的 shell 和你配置环境变量的是同一个（比如 zsh 配了，但 VS Code 默认开 bash）
- 重启 VS Code 后，按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入 “Go: Install/Update Tools”，勾选全部再试
真正容易被忽略的，是 go env -w 写入的配置会覆盖 shell 文件里的设置，且不同 Go 版本对 GOPROXY 的解析逻辑略有差异。每次升级 Go（比如从 1.23.x 升到 1.24.x），建议重跑一遍 go env -w GOPROXY=... 和 go env -w GO111MODULE=on。
