go 1.25+ 安装无需手动配 goroot/gopath,但必须重启终端使 go env -w 设置生效;国内务必配置 go111module=on、goproxy=https://goproxy.cn,direct 和 gosumdb=sum.golang.org,否则工具安装与依赖拉取将失败。

Go 1.25+ 安装已无需手动配 GOROOT 和 GOPATH,Windows 用 .msi、macOS 用 .pkg 或 brew install go、Linux 用 tar -C /usr/local -xzf 解压即可完成基础安装;真正影响开发体验的,是代理、工具链和 IDE 插件这三块。
Windows 安装后必须关掉所有 CMD/PowerShell 窗口
这是最常被忽略的一步。哪怕你看到 go version 能输出,只要没重启终端,go env -w 设置的变量(比如 GOPROXY)就不会生效——因为环境变量只在新进程里加载。
- 安装完
go1.25.0.windows-amd64.msi后,立刻关闭所有命令行窗口 - 重新打开 PowerShell 或 CMD,再运行
go version和go env | findstr GOPROXY - 如果
GOPROXY没显示,说明旧窗口还在读旧环境,不是安装失败
国内必须配置 GOPROXY=...direct,否则 go install 会卡死
go install 命令下载 gopls、dlv、staticcheck 这类工具时,默认走 golang.org,国内基本超时失败。不配 direct 后缀的话,一旦镜像站没同步某个 commit,就会彻底拉不到。
- 执行这三条(顺序不能错):
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org -
goproxy.cn是七牛云维护的镜像,覆盖 Go 1.13–1.26 全部版本,比阿里云镜像更稳定 - 别用
https://mirrors.aliyun.com/golang/——它只提供安装包下载,不支持go install的模块代理协议
VS Code 第一次打开 .go 文件,必须点 “Install” 不是 “Skip”
VS Code 的 Go 插件弹出的工具安装对话框,点 “Skip” 就等于放弃语言服务器 gopls、格式化器 goimports、调试器 dlv ——后续所有跳转、补全、保存自动格式化都会失效。
- 确保项目根目录有
go.mod(哪怕只是go mod init example.com/foo) - 设置里打开
"editor.formatOnSave": true和"go.formatTool": "goimports" - 检查
$GOPATH/bin是否在PATH中:运行where dlv(Windows)或which dlv(macOS/Linux),应返回路径
Linux/macOS 用户注意 /usr/local/go 权限与 PATH 加载时机
Linux 手动解压到 /usr/local/go 后,go 命令能用,但 go install 下载的工具可能找不到——常见原因是 shell 配置文件(如 ~/.zshrc)里漏了 $GOPATH/bin。
- 确认
go env GOPATH输出的是$HOME/go(Go 1.22+ 默认值) - 在
~/.zshrc或~/.bashrc末尾加两行:export PATH=$PATH:$HOME/go/binexport PATH=$PATH:/usr/local/go/bin - 改完必须
source ~/.zshrc,否则新开终端才生效
真正卡住人的从来不是“装不上”,而是 gopls 启不来、dlv 找不到、go run 报 cannot find module 却查不出哪条环境变量漏了——这些都发生在安装完成之后,且错误信息不指向根源。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











