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 下载安装包 #

  1. 访问Go官网下载页面:https://go.dev/dl/
  2. 选择Windows版本的安装包(如:go1.22.0.windows-amd64.msi)
  3. 下载并运行安装程序

2.2 安装步骤 #

  1. 双击.msi文件启动安装向导
  2. 接受许可协议
  3. 选择安装路径(默认:C:\Go
  4. 点击Install完成安装

2.3 验证安装 #

打开命令提示符或PowerShell:

powershell
go version

2.4 环境变量 #

安装程序会自动配置:

  • GOROOT:Go安装目录(如:C:\Go
  • PATH:添加%GOROOT%\bin

如需手动配置:

  1. 右键"此电脑" → “属性” → “高级系统设置”
  2. 点击"环境变量"
  3. 在系统变量中添加/修改

三、macOS安装 #

3.1 使用安装包 #

  1. 访问 https://go.dev/dl/
  2. 下载macOS版本(如:go1.22.0.darwin-amd64.pkg)
  3. 双击.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 手动安装(推荐) #

  1. 下载压缩包:
bash
wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz
  1. 解压到/usr/local:
bash
sudo tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz
  1. 配置环境变量:
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扩展 #

  1. 安装VS Code
  2. 安装Go扩展(Google官方)
  3. 安装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的安装非常简单:

  1. 下载对应平台的安装包
  2. 运行安装程序或解压
  3. 配置环境变量
  4. 验证安装

推荐配置:

  • 使用Go Modules管理依赖
  • 配置国内代理加速下载
  • 使用VS Code + Go扩展开发

准备好开始写第一个Go程序了吗?让我们进入下一章!

最后更新:2026-03-26