Skip to content
On this page

安装与配置

本指南将帮助你在不同操作系统上安装和配置 Go 开发环境。

下载 Go

访问 Go 官方下载页面 获取最新版本。

Windows 安装

方法一:使用 MSI 安装包

  1. 下载 .msi 安装文件
  2. 双击运行安装程序
  3. 按照向导完成安装
  4. 安装程序会自动配置环境变量

方法二:使用压缩包

  1. 下载 .zip 压缩包
  2. 解压到 C:\Go 目录
  3. 手动配置环境变量:
powershell
# 设置 GOROOT
[Environment]::SetEnvironmentVariable("GOROOT", "C:\Go", "Machine")

# 添加到 PATH
[Environment]::SetEnvironmentVariable("Path", $env:Path + ";C:\Go\bin", "Machine")

macOS 安装

使用 Homebrew(推荐)

bash
# 安装 Homebrew(如果尚未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Go
brew install go

使用安装包

  1. 下载 .pkg 安装文件
  2. 双击运行安装程序
  3. 按照向导完成安装

Linux 安装

Ubuntu/Debian

bash
# 下载并安装
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

# 配置环境变量
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
source ~/.bashrc

CentOS/RHEL/Fedora

bash
# 使用 dnf/yum
sudo dnf install golang

# 或手动安装
wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

验证安装

安装完成后,打开终端验证:

bash
go version

预期输出:

go version go1.21.5 windows/amd64

配置环境变量

GOROOT

Go 的安装目录,通常不需要手动设置(Windows MSI 安装会自动设置)。

bash
# Linux/macOS
export GOROOT=/usr/local/go

# Windows
set GOROOT=C:\Go

GOPATH

工作目录,用于存放 Go 代码和依赖。从 Go 1.11 开始,使用 Go Modules 后,GOPATH 不再是必须的。

bash
# Linux/macOS
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

# Windows
set GOPATH=%USERPROFILE%\go
set PATH=%PATH%;%GOPATH%\bin

启用 Go Modules

从 Go 1.16 开始,Go Modules 默认启用。对于旧版本:

bash
go env -w GO111MODULE=on

配置代理

在国内访问 Go 模块可能需要代理:

bash
# 设置国内代理
go env -w GOPROXY=https://goproxy.cn,direct

# 或阿里云代理
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct

配置 IDE

Visual Studio Code

  1. 安装 VS Code
  2. 安装 Go 扩展(搜索 "Go" by Go Team at Google)
  3. 安装 Go 工具:

Ctrl+Shift+P,输入 "Go: Install/Update Tools",选择所有工具安装。

GoLand

GoLand 是 JetBrains 推出的专业 Go IDE,功能强大但收费。

Vim/Neovim

使用 vim-go 插件:

vim
Plug 'fatih/vim-go', { 'do': ':GoUpdateBinaries' }

第一个程序

创建项目目录:

bash
# 创建项目目录
mkdir -p $HOME/go/src/hello
cd $HOME/go/src/hello

# 初始化模块
go mod init hello

创建 main.go

go
package main

import "fmt"

func main() {
    fmt.Println("Hello, World!")
}

运行程序:

bash
# 直接运行
go run main.go

# 编译并运行
go build -o hello
./hello

常用命令

命令说明
go run编译并运行程序
go build编译程序
go test运行测试
go get下载依赖
go mod init初始化模块
go mod tidy整理依赖
go fmt格式化代码
go vet静态分析
go doc查看文档

常见问题

1. 命令未找到(command not found)

检查 PATH 环境变量是否正确配置。

2. 代理问题

设置 GOPROXY 环境变量使用国内镜像。

3. 权限问题(Linux/macOS)

确保 /usr/local/go/bin 有执行权限:

bash
sudo chmod +x /usr/local/go/bin/go

下一步

环境配置完成后,让我们编写 第一个 Go 程序

基于 MIT 许可发布