跳到主要内容

Go 环境配置

本章将介绍如何安装 Go 和配置开发环境。

安装 Go​

Windows 系统​

方法一：下载安装包​

  1. 访问 Go 下载页面
  2. 下载 Windows 安装包（.msi 文件）
  3. 双击安装包，按照提示完成安装
  4. 安装程序会自动设置环境变量

方法二：使用 Chocolatey​

choco install golang

macOS 系统​

方法一：下载安装包​

  1. 访问 Go 下载页面
  2. 下载 macOS 安装包（.pkg 文件）
  3. 双击安装包，按照提示完成安装

方法二：使用 Homebrew​

brew install go

Linux 系统​

使用包管理器​

# Ubuntu / Debian
sudo apt update
sudo apt install golang-go

# Fedora
sudo dnf install golang

手动安装​

# 下载 Go
wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz

# 解压到 /usr/local
sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz

# 添加到 PATH
export PATH=$PATH:/usr/local/go/bin

# 永久添加到 ~/.profile
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.profile
source ~/.profile

验证安装​

打开终端（Windows 使用 CMD 或 PowerShell），输入以下命令：

go version

如果显示类似以下内容，说明安装成功：

go version go1.21.0 darwin/arm64

配置环境变量​

GOPATH 和 GOROOT​

  • GOROOT：Go 的安装目录
  • GOPATH：工作目录，存放源代码和依赖

Windows 系统​

  1. 右键"此电脑" → "属性"
  2. 点击"高级系统设置"
  3. 点击"环境变量"
  4. 在"系统变量"中编辑 Path，添加 C:\Go\bin
  5. 创建 GOPATH 变量，值为 C:\Users\你的用户名\go

macOS / Linux 系统​

在 ~/.bashrc 或 ~/.zshrc 中添加：

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

开发工具​

VS Code​

VS Code 是最流行的 Go 开发工具之一。

安装 VS Code​

  1. 下载 VS Code
  2. 安装 VS Code

安装 Go 扩展​

  1. 打开 VS Code
  2. 按 Ctrl+P（macOS 为 Cmd+P）
  3. 输入 ext install golang.go
  4. 点击安装

配置 Go 工具​

安装扩展后，按 Ctrl+Shift+P，输入 "Go: Install/Update Tools"，选择所有工具进行安装。

GoLand​

GoLand 是 JetBrains 开发的 Go 专用 IDE，功能强大。

  1. 下载 GoLand
  2. 安装并激活
  3. 配置 SDK 路径

Vim / Neovim​

对于喜欢使用 Vim 的开发者：

# 安装 vim-go 插件
vim +PlugInstall golang/go.vim +q

第一个 Go 程序​

创建项目目录​

# 创建项目目录
mkdir hello
cd hello

# 初始化 Go 模块
go mod init hello

编写代码​

创建 main.go 文件：

package main

import "fmt"

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

运行程序​

# 运行程序
go run main.go

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

输出：

Hello, Go!

Go 模块​

Go 1.11 引入了模块支持，使用 go mod 管理依赖。

常用命令​

# 初始化模块
go mod init 模块名

# 下载依赖
go mod download

# 添加依赖
go get github.com/gin-gonic/gin

# 整理依赖
go mod tidy

# 列出依赖
go list -m all

示例：创建一个 Web 服务​

  1. 创建项目并初始化模块
mkdir webserver
cd webserver
go mod init webserver
  1. 安装 Gin 框架
go get github.com/gin-gonic/gin
  1. 编写代码
package main

import "github.com/gin-gonic/gin"

func main() {
    r := gin.Default()
    
    r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "Hello, Go!",
        })
    })
    
    r.Run(":8080")
}
  1. 运行
go run main.go
  1. 访问 http://localhost:8080

IDE 配置建议​

VS Code 配置​

创建 .vscode/settings.json：

{
    "go.useLanguageServer": true,
    "go.formatTool": "gofmt",
    "go.lintTool": "golangci-lint",
    "go.lintOnSave": "package",
    "go.vetOnSave": "package",
    "go.buildFlags": [],
    "go.testFlags": ["-v"]
}

常用快捷键​

功能Windows/LinuxmacOS
运行F5F5
调试F5F5
格式化代码Shift+Alt+FShift+Option+F
重命名符号F2F2
查找引用Shift+F12Shift+F12

常见问题​

1. go command not found​

确保 Go 已正确安装，并且环境变量已配置。

# 检查 Go 是否安装
which go

# 检查环境变量
echo $PATH

2. GOPATH is not defined​

确保设置了 GOPATH 环境变量。

3. 下载依赖失败​

可能是网络问题，可以设置代理：

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

小结​

  1. 安装 Go：根据操作系统选择合适的安装方式
  2. 配置环境变量：设置 GOPATH 和 PATH
  3. 选择开发工具：VS Code、GoLand 或其他
  4. 第一个程序：创建并运行 Hello World
  5. Go 模块：使用 go mod 管理项目依赖

练习​

  1. 安装 Go 并验证安装成功
  2. 配置开发环境（VS Code 或 GoLand）
  3. 创建一个 Hello World 程序并运行
  4. 使用 go mod 创建一个依赖项目