1.2 环境搭建

1.2 环境搭建

在开始学习Go语言之前,我们需要先搭建好开发环境。本节将介绍如何在不同操作系统上安装和配置Go语言开发环境。

下载Go

官方下载地址

访问Go语言官方网站下载页面:https://go.dev/dl/

选择适合你操作系统的版本:

  • Windows: .msi 安装包

  • macOS: .pkg 安装包

  • Linux: .tar.gz 压缩包

版本选择

建议下载最新的稳定版本。截至本教程编写时,最新版本为Go 1.21+。

Windows系统安装

1. 下载安装包

下载 go1.21.x.windows-amd64.msi 文件。

2. 运行安装程序

双击下载的.msi文件,按照安装向导进行安装。

默认安装路径:C:\Program Files\Go

3. 验证安装

打开命令提示符(CMD)或PowerShell,输入:

go version

如果显示Go版本信息,说明安装成功:

go version go1.21.5 windows/amd64

4. 配置环境变量

安装程序会自动配置环境变量,但你可以手动检查:

  • GOROOT: Go的安装目录(如 C:\Program Files\Go

  • GOPATH: Go的工作目录(默认为 %USERPROFILE%\go

  • Path: 应包含 %GOROOT%\bin%GOPATH%\bin

macOS系统安装

方法一:使用安装包

  1. 下载 go1.21.x.darwin-amd64.pkggo1.21.x.darwin-arm64.pkg(M1/M2芯片)

  2. 双击运行安装程序

  3. 按照向导完成安装

默认安装路径:/usr/local/go

方法二:使用Homebrew

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

# 安装Go
brew install go

验证安装

打开终端,输入:

go version

配置环境变量

编辑 ~/.zshrc~/.bash_profile

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

使配置生效:

source ~/.zshrc  # 或 source ~/.bash_profile

Linux系统安装

1. 下载压缩包

wget https://go.dev/dl/go1.21.5.linux-amd64.tar.gz

2. 解压到指定目录

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz

3. 配置环境变量

编辑 ~/.bashrc~/.profile

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

使配置生效:

source ~/.bashrc

4. 验证安装

go version

配置Go环境

GOPATH目录结构

GOPATH是Go的工作目录,通常包含三个子目录:

$GOPATH/
├── bin/      # 存放编译后的可执行文件
├── pkg/      # 存放编译后的包文件
└── src/      # 存放源代码

Go Modules(推荐)

从Go 1.11开始,Go引入了Go Modules作为官方的依赖管理工具。使用Go Modules后,项目可以放在任意目录。

启用Go Modules:

go env -w GO111MODULE=on

配置代理(中国大陆用户)

由于网络原因,建议配置Go模块代理:

# 使用七牛云代理
go env -w GOPROXY=https://goproxy.cn,direct

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

查看Go环境配置

go env

常用环境变量:

  • GOROOT: Go安装目录

  • GOPATH: Go工作目录

  • GOPROXY: 模块代理

  • GO111MODULE: 是否启用Go Modules

  • GOOS: 目标操作系统

  • GOARCH: 目标架构

选择开发工具

1. Visual Studio Code(推荐)

优点

  • 免费开源

  • 插件丰富

  • 跨平台

  • 轻量级

安装步骤

  1. 下载安装VS Code:https://code.visualstudio.com/

  2. 安装Go扩展:在扩展市场搜索"Go",安装官方Go扩展

  3. 安装Go工具:打开命令面板(Ctrl+Shift+P),输入"Go: Install/Update Tools",全选安装

2. GoLand

优点

  • JetBrains出品

  • 功能强大

  • 智能提示完善

缺点

  • 收费(有免费试用期)

  • 相对较重

下载地址:https://www.jetbrains.com/go/

3. Vim/Neovim

适合喜欢命令行的开发者,需要配置vim-go插件。

4. Sublime Text

轻量级编辑器,需要安装GoSublime插件。

创建第一个工作空间

使用Go Modules

  1. 创建项目目录:

mkdir hello-go
cd hello-go
  1. 初始化Go模块:

go mod init hello-go

这会创建一个go.mod文件,用于管理依赖。

  1. 创建主文件:

# Windows
type nul > main.go

# macOS/Linux
touch main.go

常用Go命令

go version

查看Go版本:

go version

go env

查看Go环境变量:

go env

go mod

模块管理:

go mod init <module-name>  # 初始化模块
go mod tidy                # 整理依赖
go mod download            # 下载依赖
go mod vendor              # 将依赖复制到vendor目录

go build

编译程序:

go build              # 编译当前目录
go build main.go      # 编译指定文件
go build -o app       # 指定输出文件名

go run

编译并运行:

go run main.go

go install

编译并安装到$GOPATH/bin:

go install

go get

下载并安装包:

go get github.com/gin-gonic/gin

go test

运行测试:

go test
go test -v            # 详细输出
go test -cover        # 显示覆盖率

go fmt

格式化代码:

go fmt ./...          # 格式化所有文件

验证环境配置

创建一个简单的测试程序验证环境:

// main.go
package main

import "fmt"

func main() {
    fmt.Println("Go环境配置成功!")
}

运行程序:

go run main.go

如果输出"Go环境配置成功!",说明环境配置完成。

常见问题

1. go命令找不到

解决方法:检查PATH环境变量是否包含Go的bin目录。

2. 无法下载依赖包

解决方法:配置GOPROXY代理。

3. VS Code Go扩展工具安装失败

解决方法

  1. 配置GOPROXY

  2. 手动安装工具:

go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/delve/cmd/dlv@latest

4. 权限问题(Linux/macOS)

解决方法:确保GOPATH目录有写权限。

小结

本节我们学习了:

  • 如何在不同操作系统上安装Go

  • 如何配置Go环境变量

  • 如何选择和配置开发工具

  • 常用的Go命令

环境搭建完成后,我们就可以开始编写Go程序了。下一节,我们将编写第一个Go程序。


上一节: 1.1 Go语言简介 | 下一节: 1.3 第一个Go程序

返回目录 | 返回首页