直接安装.msi(Windows)或.pkg(macOS)包即可,无需手动配置环境变量;安装后必须关闭所有终端再执行go version验证,成功显示go1.25.0 windows/amd64即完成。

直接装 .msi(Windows)或 .pkg(macOS)安装包,配好国内代理,就能写 go run main.go 了。不用手动改环境变量,也不用纠结 GOPATH。
Windows 上双击安装就完事,但必须关掉所有终端再验证
下载 go1.25.0.windows-amd64.msi(2026年最新稳定版),双击一路 Next,默认路径 C:\Program Files\Go 即可。安装程序会自动把 C:\Program Files\Go\bin 加进系统 PATH。
关键点:
- 安装完必须关闭所有已打开的 CMD / PowerShell 窗口,否则
go version会报“不是内部或外部命令” - 重新开一个终端,执行
go version,看到类似go version go1.25.0 windows/amd64就成功了 -
GOROOT一般不用手动设;如果改过安装路径,才需要在系统环境变量里加GOROOT指向新目录
Linux/macOS 用包管理器最省心,但注意 shell 配置文件差异
macOS 推荐用 Homebrew:brew install go,它自动处理 PATH 和 GOROOT;Linux(Ubuntu/Debian)可用 sudo apt-get install golang-go,CentOS 用 sudo yum install golang。
立即学习“go语言免费学习笔记(深入)”;
如果手动解压 .tar.gz(比如想用特定版本),要注意:
- Linux 通常写入
/etc/profile或用户级~/.bashrc,macOS 新系统默认用zsh,得改~/.zshrc - 必须包含这两行:
export PATH=$PATH:/usr/local/go/bin和(可选)export GOPATH=$HOME/go - 改完要
source ~/.zshrc(或对应文件),否则终端不认go命令
国内拉包必配代理,否则 go mod download 卡死或超时
Go 默认走国外源,不配代理的话,go get、go mod tidy 基本都会失败,错误信息常见 timeout 或 no matching versions。
执行这三条命令(永久生效):
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct go env -w GOSUMDB=sum.golang.org
验证是否生效:go env | grep GOPROXY 应输出你刚设的地址。注意 direct 是必需的——它保证代理找不到包时能回源官方仓库,避免私有模块拉不到。
第一个项目别碰 GOPATH,直接用 go mod init
Go 1.16+ 默认启用模块模式,GOPATH 已非必需。新建空文件夹,执行:
go mod init hello
echo 'package main\nimport "fmt"\nfunc main() { fmt.Println("Hello, Go!") }' > main.go
go run main.go
看到输出 Hello, Go! 就通了。重点:
- 项目名(
go mod init hello中的hello)只是模块路径前缀,不一定要和文件夹名一致 - 不要手动建
$GOPATH/src目录再往里放代码,那是旧模式,容易和模块冲突 - 如果编辑器(如 VS Code)提示缺少工具(
gopls、dlv),运行go install golang.org/x/tools/gopls@latest等命令单独装,它们默认装到$GOPATH/bin,所以确保该路径也在PATH里
最容易被忽略的是:代理配置后没验证、终端没重启、shell 配置文件改错(比如 zsh 写成 bashrc)、以及还在用 GOPATH/src 旧习惯初始化项目。这四点占新手失败原因的 80% 以上。


















