Go语言开发环境搭建教程

以下是 Go 语言开发环境搭建的详细步骤，适用于 Windows、macOS 和 Linux 系统：

1. 安装 Go 编译器

下载地址

• 官网: https://golang.org/dl/
• 国内镜像: https://golang.google.cn/dl/

安装步骤

• Windows:
• 下载 .msi 安装包，双击运行。
• 按照提示选择安装路径（默认 C:\Go）。
• 安装完成后会自动添加环境变量。
• macOS:

• 下载 .pkg 安装包，双击安装。
• 默认安装路径为 /usr/local/go。

• Linux:

• 下载 .tar.gz 包，解压到 /usr/local:

bash

sudo tar -C /usr/local -xzf goX.XX.X.linux-amd64.tar.gz

• 设置环境变量（见下文）。

2. 配置环境变量

Go 依赖以下环境变量：

• GOROOT: Go 的安装路径（自动设置）。
• GOPATH: 工作目录（存放代码和依赖包，默认 ~/go）。
• PATH: 添加 $GOROOT/bin 和 $GOPATH/bin。

配置方法

• Windows:
• 右键“此电脑” → 属性 → 高级系统设置 → 环境变量。
• 新建系统变量 GOPATH，值为你的工作目录（如 D:\GoProjects）。
• 在 Path 中添加 %GOROOT%\bin 和 %GOPATH%\bin。
• macOS/Linux:
  编辑 ~/.bashrc 或 ~/.zshrc，添加：

bash

export GOPATH=$HOME/go

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

执行 source ~/.bashrc 生效。

3. 验证安装

打开终端/命令行，输入：

bash

go version

输出类似 go version go1.21.0 linux/amd64 表示成功。

4. 配置代理（国内推荐）

解决依赖下载慢的问题：

bash

go env -w GO111MODULE=on

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

5. 安装开发工具

编辑器/IDE

• VS Code + Go 插件：
• 安装 VS Code。
• 安装 Go 扩展：搜索并安装 Go 插件。
• VS Code 会提示安装依赖工具（gopls, dlv 等），确认安装。
• Goland（JetBrains 出品）：

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

O 功能强大，适合大型项目。

6. 创建第一个 Go 程序

1. 新建文件 hello.go:

go

package main

import "fmt"

func main() {

fmt.Println("Hello, Go!")

}

2. 运行代码：

bash

go run hello.go

输出 Hello, Go! 表示环境正常。

7. 项目依赖管理（Go Modules）

1. 初始化模块：

bash

go mod init example.com/hello

2. 添加依赖：

bash

go get github.com/gin-gonic/gin

3. 自动生成 go.mod 和 go.sum 文件。

8. 常用命令

• go build: 编译代码。
• go test: 运行测试。
• go fmt: 格式化代码。
• go mod tidy: 清理依赖。

9. 调试工具

• Delve:

bash

go install github.com/go-delve/delve/cmd/dlv@latest

在 VS Code 中按 F5 启动调试。

常见问题

1. 权限问题（Linux/macOS）:
   确保 GOPATH 目录有读写权限：

bash

chmod -R 755 $GOPATH

2. 依赖下载失败:
   检查代理配置或手动设置 GOPROXY。

完成以上步骤后，你的 Go 开发环境就搭建好了！开始编写 Go 代码吧