初学者应直接安装Go官方二进制包,禁用包管理器;Go 1.16+默认启用Modules,无需配置GOPATH;VS Code仅需安装官方Go扩展并设置GOPROXY=https://goproxy.cn,direct。

直接装官方二进制包,别碰包管理器;Go 1.16+ 默认启用 Modules,根本不用配 GOPATH;VS Code 装一个插件就够了——Go(由 golang 官方维护),其他全是干扰项。
Windows/macOS/Linux 用什么安装包?
统一原则:跳过 homebrew、apt、choco 等包管理器。它们版本滞后、路径混乱,新手极易卡在“go command not found”。
- Windows:下载
goxxx.windows-amd64.msi,双击安装,全程默认即可(自动写入PATH) - macOS(Intel):下载
goxxx.darwin-amd64.pkg;M1/M2/M3 芯片选goxxx.darwin-arm64.pkg - Linux:下载
goxxx.linux-amd64.tar.gz,解压到/usr/local:sudo tar -C /usr/local -xzf go*.tar.gz
验证是否成功,只用一条命令:go version。能输出类似 go version go1.25.0 linux/amd64 就算过关。
为什么不要手动配 GOPATH?
因为 Go 1.16 起默认开启 GO111MODULE=on,模块化已成事实标准。你再设 GOPATH,反而会干扰工具链行为,比如 go run 找不到本地包、gopls 提示 import 错误。
立即学习“go语言免费学习笔记(深入)”;
- 新建项目时,任意目录执行:
mkdir hello && cd hello && go mod init hello -
hello是模块名,不是路径,也不必是域名;它只用于import引用本地子包 - 删掉
go.mod和go.sum就退回到无模块状态,但没必要——新项目没理由倒退
VS Code 只装一个插件,但必须配代理
打开 VS Code → 搜索扩展 → 安装 Go(作者:golang)。它会自动拉取 gopls、dlv、gofmt 等核心工具。但国内用户不配代理,gopls 会卡死在 “loading”,代码补全、跳转全部失效。
- 终端执行(永久生效):
go env -w GOPROXY=https://goproxy.cn,direct
- 验证:
go env | grep GOPROXY应输出你刚设的地址 - 重启 VS Code,打开任意
.go文件,底部状态栏看到gopls (running)才算真正就绪
最容易被忽略的点:安装后必须关掉所有已打开的终端/CMD/PowerShell,否则环境变量不生效;还有,gopls 启动失败时别急着重装插件——八成是代理没配,而不是插件坏了。


















