根本原因是Windows未将Go安装路径添加到PATH环境变量，需手动将Go的bin目录（如C:\Program Files\Go\bin）加入用户级PATH并重启命令行；同时需配置GOPROXY代理（如https://goproxy.cn,direct）以解决go get超时问题。
go 环境在 Windows 上装不起来，八成是环境变量没生效或代理没配——不是下载错了，也不是系统不兼容。
安装后 go version 报“不是内部或外部命令”
这是最常见、也最容易被忽略的问题：Windows 的 .msi 安装包虽然自动写入了 PATH，但**已打开的 CMD/PowerShell 不会自动继承新环境变量**。
- 必须关闭所有已打开的终端窗口（包括 VS Code 内置终端），再新开一个
- 检查
GOROOT是否被正确设置（go env GOROOT应输出类似C:\Program Files\Go） - 如果手动改过安装路径（比如装到
D:\Go），确认PATH里加的是D:\Go\bin，而不是默认路径 - 别用“以管理员身份运行”的 CMD 去验证——它可能读的是另一套用户环境变量
go get 卡住或报 timeout / no matching versions
Go 默认走 proxy.golang.org，国内直连基本不可用。不配代理，go mod tidy 或任何拉第三方包的操作都会失败。
- 执行这三条命令（永久生效）：
go env -w GO111MODULE=on<br>go env -w GOPROXY=https://goproxy.cn,direct<br>go env -w GOSUMDB=sum.golang.org
-
GOPROXY后的direct很关键：它让代理查不到的包（比如私有仓库）自动回源，避免直接报错 - 验证是否生效：
go env GOPROXY必须输出https://goproxy.cn,direct，不能只看到direct或空值 - 如果公司内网禁用了
goproxy.cn，可换阿里云镜像：https://mirrors.aliyun.com/goproxy/
VS Code 里代码不提示、go fmt 失败、调试器启动不了
这不是插件没装，而是 Go 工具链本身没下载全。VS Code 的 Go 插件依赖 gopls、dlv、gofumpt 等二进制工具，它们默认从境外拉取，且不会主动提示失败。
- 在 VS Code 中按
Ctrl+Shift+P→ 输入Go: Install/Update Tools→ 全选并安装 - 如果卡在某个工具（比如
dlv），手动在终端执行：GO111MODULE=on go install github.com/go-delve/dlv/cmd/dlv@latest
- 确保
GOBIN已加入PATH（go env GOBIN查看路径，通常为%GOPATH%\bin） - VS Code 设置里关掉
go.useLanguageServer是自废武功——gopls才是现代 Go 开发的核心语言服务
go run 正常但 go build 出错，或编译出的二进制无法运行
这类问题往往藏在模块初始化和工作目录里。Go 1.16+ 默认启用模块模式，但很多人仍习惯在任意目录下直接 go run main.go，而忽略了 go.mod 文件的存在与否。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目务必先
go mod init example.com/myapp（域名只是命名空间，不用真实存在） - 不要把项目放在
%GOPATH%\src下再用模块——二者逻辑冲突，容易触发cannot find module providing package -
go build前确认当前目录含go.mod，且main.go在根目录或cmd/子目录下 - Windows 上编译出的
.exe若双击无反应，用 CMD 运行看报错：大概率是缺失 DLL（如msvcp140.dll），需安装 Microsoft Visual C++ Redistributable
