Go 语言安装指南

本指南将帮助你在各种操作系统上安装 Go 语言。

🖥️ 快速选择你的平台

选择你的操作系统，查看详细的安装指南：

🪟 WindowsMSI 安装包、Chocolatey、Scoop、ZIP 便携安装、goup 多版本管理 🍎 macOSPKG 安装包、Homebrew、源码编译、goup 多版本管理 🐧 Linux官方二进制包、apt/yum/dnf、Snap、goup 多版本管理

📊 各平台安装方式对比

操作系统	图形化安装	命令行安装	包管理器	便携版	多版本管理
Windows	MSI	✅	Chocolatey / Scoop	ZIP	goup
macOS	PKG	✅	Homebrew	-	goup
Linux	-	tar.gz	apt / yum / dnf / Snap	✅	goup

💡 提示：如果你是第一次安装，推荐使用图形化安装或包管理器方式。

🌟 goup 是跨平台的 Go 版本管理工具，支持 Windows/macOS/Linux，适合需要管理多个 Go 版本的场景。

📚 按读者水平选择安装方式

🟢 无技术背景

🔵 初级开发者

🟡 中级开发者

🟠 高级开发者

🔴 专业开发者

适合人群：第一次安装软件，希望使用图形界面

平台	推荐方式	特点
Windows	MSI 安装包	双击安装，自动配置环境
macOS	PKG 安装包	双击安装，自动配置环境
Linux	Snap/软件中心	图形界面操作

适合人群：熟悉命令行，希望方便更新

平台	推荐方式	特点
Windows	Chocolatey	包管理器，一键安装更新
macOS	Homebrew	包管理器，一键安装更新
Linux	apt/yum/dnf	系统包管理器直接安装

适合人群：需要在不同项目间切换 Go 版本

平台	推荐方式	特点
全平台	goup	跨平台版本管理，项目级版本锁定

goup 优势：

✅ 真正的跨平台支持（Windows/macOS/Linux）
✅ 一行命令安装，无需预装 Go
✅ 支持项目级版本锁定（.go-version 文件）

平台	推荐方式	特点
macOS	源码编译	自定义编译选项
Linux	源码编译	自定义编译选项

部署方式	说明
Docker	容器化部署，环境隔离
CI/CD	自动化构建集成

🔴 专业开发者 - 企业部署

Docker 容器化部署

# Dockerfile
FROM golang:1.26.0 AS builder
WORKDIR /app
COPY . .
RUN go build -o app

FROM alpine:latest
COPY --from=builder /app/app /usr/local/bin/app
CMD ["app"]

CI/CD 集成

GitHub Actions 示例：

name: Go Build
on: [push, pull_request]
jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        go-version: ["1.25", "1.26"]
    steps:
      - name: Install goup
        run: curl -sSf https://raw.githubusercontent.com/owenthereal/goup/master/install.sh | sh

      - name: Install Go
        run: |
          source $HOME/.go/env
          goup install ${{ matrix.go-version }}
          goup use ${{ matrix.go-version }}

      - uses: actions/checkout@v3
      - run: go test ./...
      - run: go build -v ./...

🔧 环境变量配置（跨平台）

基本配置（所有用户必需）

# Linux/macOS - 添加到 ~/.bashrc 或 ~/.zshrc
export PATH=$PATH:/usr/local/go/bin
export PATH=$PATH:$HOME/go/bin

# Windows PowerShell
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Program Files\Go\bin", "User")

中国用户网络加速

# 设置国内 Go 代理（选择其一）
go env -w GOPROXY=https://goproxy.cn,direct
# 或
go env -w GOPROXY=https://goproxy.io,direct

国内 Go 代理服务：

https://goproxy.cn - 七牛云提供的 Go 模块代理
https://goproxy.io - 全球知名的 Go 模块代理

✅ 安装验证（跨平台）

基础验证

# 检查版本
go version

# 查看环境变量
go env

# 检查关键路径
which go        # Linux/macOS
where go        # Windows
go env GOROOT
go env GOPATH

完整验证脚本

#!/bin/bash
echo "=== Go 安装验证 ==="
echo "Go 版本: $(go version)"
echo "GOROOT: $(go env GOROOT)"
echo "GOPATH: $(go env GOPATH)"
echo "=== 编译测试 ==="
cd /tmp
echo 'package main; import "fmt"; func main() { fmt.Println("Hello, Go!") }' > hello.go
go run hello.go
rm hello.go

🛠️ 开发工具推荐（跨平台）

VSCode（免费，推荐新手）

安装 VSCode
安装 Go 扩展（搜索 "Go"）
打开 .go 文件时，点击 "Install All" 安装工具

GoLand（付费，功能强大）

下载 GoLand
配置 Go SDK 路径
开始开发

Vim/Neovim

# 使用 LazyVim（推荐）
git clone https://github.com/LazyVim/starter ~/.config/nvim
# 自动支持 Go

❓ 常见问题（跨平台）

Q: 安装后提示 "command not found: go"

A: PATH 环境变量未正确配置，请检查上述配置步骤。

Q: 多个 Go 版本冲突

A: 使用 goup 版本管理工具统一管理多版本。goup 支持 Windows、macOS 和 Linux，提供一致的跨平台体验。

Q: goup 和其他版本管理工具的区别

特性	goup	gvm	g
跨平台支持	✅ 全平台	❌ Unix/macOS only	❌ Unix/macOS only
安装难度	⭐ 简单	⭐⭐⭐⭐ 需要依赖	⭐ 简单
预装 Go	❌ 不需要	✅ 需要	❌ 不需要

Q: 中国用户下载慢

使用国内镜像下载：https://golang.google.cn/dl/

设置 Go 代理：

go env -w GOPROXY=https://goproxy.cn,direct
# 或
go env -w GOPROXY=https://goproxy.io,direct

📚 下一步

安装完成后，继续学习： → 编写你的第一个 Go 程序

🔗 参考资源

返回模块概览 | 继续：Hello World →

#Go 语言安装指南

#🖥️ 快速选择你的平台

#📊 各平台安装方式对比

#📚 按读者水平选择安装方式

#🔴 专业开发者 - 企业部署

#Docker 容器化部署

#CI/CD 集成

#🔧 环境变量配置（跨平台）

#基本配置（所有用户必需）

#中国用户网络加速

#✅ 安装验证（跨平台）

#基础验证

#完整验证脚本

#🛠️ 开发工具推荐（跨平台）

#VSCode（免费，推荐新手）

#GoLand（付费，功能强大）

#Vim/Neovim

#❓ 常见问题（跨平台）

#Q: 安装后提示 "command not found: go"

#Q: 多个 Go 版本冲突

#Q: goup 和其他版本管理工具的区别

#Q: 中国用户下载慢

#📚 下一步

#🔗 参考资源