本地使用 Docker 搭建 Go 开发环境全过程

使用 Docker 的优势

传统在本地直接安装 Go 环境需要配置 GOROOT、GOPATH 等变量，容易受系统环境影响且难以保持环境纯净。使用 Docker 容器化构建开发环境具有以下显著优势：

• 系统环境纯净：所有依赖运行在独立容器中，避免本地系统被大量开发工具污染。
• 环境与宿主解耦：消除因操作系统差异（如 macOS 与 Linux）导致的依赖问题，确保“本地跑通，线上必行”。
• 统一管理机制：无论是 MySQL、Redis 还是 Go，均只需拉取镜像、映射端口即可使用，标准一致。

准备条件与环境安装

以下操作基于 macOS Big Sur 系统，Windows/Linux 用户可参考类似逻辑进行适配。

第 1 步：安装 Docker Desktop

1. 前往 Docker Desktop 官网或使用国内加速地址下载对应系统的安装包。
2. 运行安装程序并遵循向导完成安装。
3. 启动终端，输入 docker version 或 docker info。若显示客户端与服务端版本信息，则表示安装成功。

第 2 步：拉取 Go 镜像

访问 Docker Hub 搜索 Go 镜像。推荐使用 Debian Buster 基础版本的镜像，以保证兼容性。以 Go 1.18 系列为例：

docker pull golang:1.18.1-buster

等待下载完成后，可通过 docker images 确认镜像已存在于本地库中。

核心配置步骤

第 3 步：启动容器并配置环境变量

首先需要启动一个临时容器来初始化 Go 的环境变量。为了简化后续操作，我们先创建一个容器并进入其中：

# 启动容器（--privileged 并非必须，视具体需求而定，此处按原文保留但建议非必要不加）
docker run -d --name temp-golang golang:1.18.1-buster

进入容器内部执行初始化设置：

# 1. 开启 Go Modules 包管理支持
go env -w GO111MODULE=on

# 2. 配置国内代理加速下载，提升依赖获取速度
go env -w GOPROXY="https://goproxy.cn"

# 3. 设置工作目录 
go env -w GOPATH="/go"

修改完毕后，可使用 go env 再次核对参数是否生效。

第 4 步：保存定制化镜像

为了避免每次新建容器都重复配置，将当前状态提交为一个新镜像，命名为 golang-local：

docker commit temp-golang golang-local

此后，你可以直接使用 golang-local 作为基础镜像，该环境已预置好模块与代理配置。

本地开发与运行验证

第 5 步：挂载目录并映射端口

为了让宿主机上的代码编辑器能直接读写项目文件，同时方便外部访问应用，需要利用 -v 挂载卷和 -p 端口映射。假设本机项目存放路径为 /Users/jay/go/project：

docker run -itd \
  -p 8080:8080 \
  -v /Users/jay/go/project:/go/src \
  --name go-dev-env \
  golang-local

参数解析：

• -itd：交互模式后台运行。
• -p 8080:8080：将容器的 8080 端口映射到宿主机的 8080 端口（请确保宿主机该端口未被占用）。
• -v /Users/jay/go/project:/go/src：将本机绝对路径挂载至容器内的代码根目录。这样在本机编辑的文件会实时同步到容器中。
• --name go-dev-env：指定容器名称，便于后续管理停止或重启。

第 6 步：验证开发环境

在本机项目目录 /Users/jay/go/project 下创建测试项目：

1. 初始化模块：go mod init gin-demo
2. 新建 main.go，编写 Gin 入门示例：

package main

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

func main() {
	r := gin.Default()

	r.GET("/ping", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "pong",
		})
	})
	r.Run(":8080")
}

进入容器进行操作：

docker exec -it go-dev-env bash

在容器内执行编译运行：

 即代表环境搭建成功。

进阶：热重载优化体验
频繁进入容器执行命令较为繁琐，建议使用 fresh 工具实现代码热更新。
在容器内安装 fresh：