Windows 安装 Go 只需运行 MSI 包并重启终端即可；常见问题为 PATH 未生效、GOPATH 误配或未初始化模块，go version 和 go run 成功即环境已就绪。
go 在 Windows 上安装非常简单，**只要下载官方 MSI 安装包、一路 Next，90% 的情况开箱即用**。真正出问题的，几乎都卡在环境变量没生效、终端没重启，或者误以为必须手动配 GOPATH。
直接运行 go version 报“不是内部或外部命令”？先检查 PATH 是否生效
这是 Windows 用户最常遇到的第一道坎——明明装完了，却在 CMD/PowerShell 里找不到 go 命令。
- MSI 安装包（尤其是 Go 1.20+）默认会把
C:\Go\bin或C:\Program Files\Go\bin加进系统PATH，但只对新打开的终端生效；已打开的 CMD/PowerShell 不会自动刷新环境变量 - 如果安装后立刻测试，务必关闭所有旧终端，再新开一个
- 仍失败？手动验证：
echo %PATH%看输出里有没有Go\bin路径；没有就去「系统属性 → 高级 → 环境变量」，在「系统变量」的Path里新增一行：C:\Go\bin（路径以你实际安装位置为准） - 注意：不要加引号，也不要末尾加反斜杠，写成
C:\Go\bin就行
为什么 go env 显示的 GOPATH 是 C:\Users\用户名\go？可以改，但通常没必要
从 Go 1.11 开始，go mod 成为默认依赖管理方式，GOPATH 不再是项目存放的强制路径。它现在主要影响两件事：go install 编译出的二进制放哪、go get 下载的旧式包存哪。
- 默认值是安全的，不建议新手手动改；改了反而容易和编辑器（如 VS Code 的 Go 扩展）工具链冲突
- 真要改，用命令比手动设环境变量更可靠：
go env -w GOPATH=D:\goprojects（Windows PowerShell 中执行） - 改完别忘了同步加
%GOPATH%\bin到PATH，否则go install出的工具无法全局调用
写完 hello.go 却执行失败？确认文件名、入口函数和模块初始化
报错如 build command-line-arguments: cannot load fmt: cannot find module providing package fmt，大概率是项目目录没初始化模块。
- Go 1.16+ 默认启用
GO111MODULE=on，要求项目必须有go.mod文件才能解析标准库以外的导入（哪怕只是"fmt"） -
解决方法很简单：在
hello.go所在目录下运行go mod init hello，生成go.mod - 确保文件名是
hello.go（不是hello.txt或隐藏扩展名），且内容严格如下：
package main
import "fmt"
func main() {
fmt.Println("Hello, Go on Windows!")
}
- 运行命令必须是
go run hello.go，不是go run .（后者要求当前是模块根目录）
VS Code 写 Go 代码时提示“Missing tools”，点安装却卡住或失败？优先用命令行手动装
VS Code 的 Go 扩展（由 golang.org/x/tools 提供）依赖多个 CLI 工具，比如 gopls（语言服务器）、dlv（调试器）。图形化安装经常因网络或权限失败。
立即学习“go语言免费学习笔记（深入）”；
- 关掉 VS Code，打开 PowerShell（以管理员身份非必需，但能避免权限拦截）
- 逐个安装关键工具：
go install golang.org/x/tools/gopls@latest、go install github.com/go-delve/delve/cmd/dlv@latest - 装完后检查：
gopls version和dlv version应正常输出；它们默认装在%GOPATH%\bin下，确保该路径已在PATH中 - 重开 VS Code，打开任意
.go文件，状态栏左下角应显示 “gopls ready”
GOPATH 强制配置习惯，套用到现代 Go Modules 项目上**。记住：只要 go version 能跑、go run 能输出，环境就算立住了；其余都是按需增强，不是起步门槛。 
