Go安装目录应选C:\Go,因其简洁无空格、权限干净且官方默认;GOPATH建议设为%USERPROFILE%\go或英文无空格路径;安装后须验证GOROOT、GOPATH和PATH是否正确生效。

Go安装目录选 C:\Go 最省心
官方推荐且安装器默认路径就是 C:\Go,不是 C:\Program Files\Go。虽然后者看似“规范”,但空格和长路径在命令行、Makefile、某些构建工具中容易引发意外问题(比如 go build 报错找不到 runtime 包)。C:\Go 简洁、无空格、权限干净,Windows 下几乎所有 Go 工具链都默认适配它。
- 安装时若看到“Choose Install Location”,直接点“Next”用默认路径即可
- 如果已装到
C:\Program Files\Go,建议卸载重装——别试图手动改GOROOT后硬扛,后续go mod或交叉编译可能静默失败 -
GOROOT必须严格等于实际安装路径,不能多一个斜杠、不能大小写混用(Windows 虽不敏感,但部分 Go 工具会校验)
GOPATH 别放系统盘根目录,也别用中文路径
GOPATH 是你写代码、存依赖、生成二进制的地方,不是安装目录。它默认是 %USERPROFILE%\go(即 C:\Users\用户名\go),这个位置合理:用户目录有完整写权限,路径不含空格,且符合 Windows 安全策略。
- 不要设成
C:\go:系统盘根目录常受 UAC 限制,go get可能因权限失败 - 不要设成
C:\Users\张三\go:中文用户名会导致go env -w GOPATH=...出现编码问题,go list可能报invalid UTF-8 - 如果想统一管理,可设为
D:\workspace\go,但需确保该路径全程英文、无空格、有读写权
安装后必须验证的三个环境变量
哪怕勾选了 “Add Go to PATH”,仍要手动确认 GOROOT、GOPATH、PATH 是否真正生效。常见错误不是“没配”,而是“配错顺序”或“配了用户变量却忘了系统变量”。
- 打开新
cmd,运行go env GOROOT→ 应输出C:\Go - 运行
go env GOPATH→ 应输出你设定的路径(如C:\Users\YourName\go) - 运行
echo %PATH%→ 查看是否同时包含C:\Go\bin和%GOPATH%\bin(注意:后者必须展开为真实路径,不能留%符号) - 若
go version成功但go run main.go报cannot find package "fmt",八成是GOROOT指向错误或PATH里混入了旧版本go\bin
Go 1.16+ 其实可以不用 GOPATH,但新手仍建议保留
模块模式(go mod)下,项目可放在任意路径,go build 不再强依赖 GOPATH。但很多教程、CI 脚本、第三方工具(如 gopls、dlv)仍默认读取 GOPATH 来定位缓存或 bin 工具。直接删掉它,反而容易触发隐性兼容问题。
立即学习“go语言免费学习笔记(深入)”;
- 保持
GOPATH设定,但开发新项目时可在任意目录执行go mod init example.com/hello -
go install默认把二进制放到%GOPATH%\bin,删了GOPATH就得额外加-o指定输出,徒增操作 - 如果你用 VS Code + Go 插件,它的测试运行、代码跳转功能底层仍会查
GOPATH缓存
go env 显示的仍是旧值。










