Go安装 #
一、安装前准备 #
1.1 系统要求 #
Go支持以下操作系统:
| 操作系统 | 架构 | 最低版本 |
|---|---|---|
| Windows | amd64, arm64 | Windows 7+ |
| macOS | amd64, arm64 | macOS 10.15+ |
| Linux | amd64, arm64, arm | 内核 2.6.32+ |
1.2 检查是否已安装 #
bash
go version
如果已安装,会显示类似:
text
go version go1.22.0 darwin/amd64
二、Windows安装 #
2.1 下载安装包 #
- 访问Go官网下载页面:https://go.dev/dl/
- 选择Windows版本的安装包(如:go1.22.0.windows-amd64.msi)
- 下载并运行安装程序
2.2 安装步骤 #
- 双击.msi文件启动安装向导
- 接受许可协议
- 选择安装路径(默认:
C:\Go) - 点击Install完成安装
2.3 验证安装 #
打开命令提示符或PowerShell:
powershell
go version
2.4 环境变量 #
安装程序会自动配置:
- GOROOT:Go安装目录(如:
C:\Go) - PATH:添加
%GOROOT%\bin
如需手动配置:
- 右键"此电脑" → “属性” → “高级系统设置”
- 点击"环境变量"
- 在系统变量中添加/修改
三、macOS安装 #
3.1 使用安装包 #
- 访问 https://go.dev/dl/
- 下载macOS版本(如:go1.22.0.darwin-amd64.pkg)
- 双击.pkg文件,按提示安装
3.2 使用Homebrew(推荐) #
bash
brew install go
3.3 验证安装 #
bash
go version
3.4 环境变量配置 #
编辑shell配置文件(~/.zshrc或~/.bash_profile):
bash
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
使配置生效:
bash
source ~/.zshrc
四、Linux安装 #
4.1 使用包管理器 #
Ubuntu/Debian:
bash
sudo apt update
sudo apt install golang-go
CentOS/RHEL:
bash
sudo yum install golang
4.2 手动安装(推荐) #
- 下载压缩包:
bash
wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz
- 解压到/usr/local:
bash
sudo tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
- 配置环境变量:
bash
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc
4.3 验证安装 #
bash
go version
五、环境变量详解 #
5.1 GOROOT #
Go的安装目录,包含Go的标准库和编译器。
bash
echo $GOROOT
5.2 GOPATH #
Go项目的工作空间,包含:
src/:源代码pkg/:编译后的包文件bin/:可执行文件
bash
echo $GOPATH
5.3 GOPROXY #
Go模块代理,加速依赖下载:
bash
go env -w GOPROXY=https://goproxy.cn,direct
国内常用代理:
| 代理地址 | 说明 |
|---|---|
| https://goproxy.cn | 七牛云 |
| https://goproxy.io | 社区维护 |
| https://mirrors.aliyun.com/goproxy/ | 阿里云 |
5.4 GO111MODULE #
模块模式控制:
bash
go env -w GO111MODULE=on
on:启用模块模式(推荐)off:禁用模块模式auto:自动判断
5.5 查看所有环境变量 #
bash
go env
六、多版本管理 #
6.1 使用go install #
安装其他版本:
bash
go install golang.org/dl/go1.21.0@latest
go1.21.0 download
使用特定版本:
bash
go1.21.0 version
6.2 使用gvm #
安装gvm:
bash
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
安装Go版本:
bash
gvm install go1.22.0
gvm use go1.22.0
七、开发工具推荐 #
7.1 VS Code + Go扩展 #
- 安装VS Code
- 安装Go扩展(Google官方)
- 安装Go工具:
bash
go install golang.org/x/tools/gopls@latest
7.2 GoLand #
JetBrains出品的Go IDE,功能强大但收费。
7.3 Vim/Neovim #
使用vim-go或LSP配置。
八、常用命令 #
| 命令 | 说明 |
|---|---|
go version |
查看Go版本 |
go env |
查看环境变量 |
go build |
编译程序 |
go run |
编译并运行 |
go test |
运行测试 |
go mod init |
初始化模块 |
go get |
下载依赖 |
go fmt |
格式化代码 |
go vet |
静态分析 |
九、安装验证 #
创建测试文件hello.go:
go
package main
import "fmt"
func main() {
fmt.Println("Go安装成功!")
}
运行:
bash
go run hello.go
输出:
text
Go安装成功!
十、常见问题 #
10.1 go: command not found #
原因:PATH未正确配置
解决:确保$GOROOT/bin在PATH中
10.2 依赖下载失败 #
原因:网络问题
解决:配置GOPROXY
bash
go env -w GOPROXY=https://goproxy.cn,direct
10.3 GOPATH模式问题 #
原因:项目不在GOPATH下
解决:使用Go Modules
bash
go mod init example.com/myproject
十一、总结 #
Go的安装非常简单:
- 下载对应平台的安装包
- 运行安装程序或解压
- 配置环境变量
- 验证安装
推荐配置:
- 使用Go Modules管理依赖
- 配置国内代理加速下载
- 使用VS Code + Go扩展开发
准备好开始写第一个Go程序了吗?让我们进入下一章!
最后更新:2026-03-26