infinitetactics/it-golang-dev

Golang开发基础镜像（VSCode支持）

镜像概述

该镜像为Golang开发者提供集成VSCode支持的基础开发环境，旨在简化Golang项目的开发环境搭建流程。通过预配置Golang运行时、开发工具及VSCode远程开发所需组件，实现"一键启动"的容器化开发体验，确保开发环境的一致性和可重复性。

核心功能与特性

• 完整Golang环境：预装Golang运行时及标准工具链，支持项目构建、调试和测试
• VSCode远程开发支持：内置Remote - Containers/SSH配置，无缝对接VSCode远程开发扩展
• 开发工具集成：包含Git、GOPROXY配置工具、Delve调试器等常用开发组件
• 环境变量定制：支持自定义GOPATH、GOROOT、GOPROXY等关键环境变量
• 轻量级设计：基于精简Linux发行版构建，减少镜像体积，提升启动效率
• 持久化工作区：支持本地项目目录挂载，确保开发文件持久化存储

使用场景与适用范围

• 个人/团队Golang项目的本地开发环境
• 跨平台开发环境统一（Windows/macOS/Linux一致体验）
• 临时测试环境快速搭建
• 教学/培训场景中的标准化开发环境
• 主机系统隔离需求（避免开发依赖污染主机环境）

使用方法与配置说明

基础启动命令（docker run）

bash
docker run -d \
  --name golang-vscode-dev \
  -v /本地/golang项目路径:/workspace \
  -p 2222:22 \  # SSH远程端口（若使用SSH连接）
  -e GOLANG_VERSION=1.21 \  # 可选，指定Golang版本
  -e GOPROXY=https://goproxy.cn,direct \  # 可选，配置国内代理
  -e GOPATH=/workspace/go \  # 可选，指定工作目录
  [镜像名称]:[标签]

VSCode远程连接配置

方法1：通过Remote - Containers扩展

1. 安装VSCode及"Remote - Containers"扩展
2. 打开命令面板（Ctrl+Shift+P），选择"Remote-Containers: Attach to Running Container"
3. 在容器列表中选择名称为golang-vscode-dev的容器，自动建立连接

方法2：通过SSH连接

1. 确保容器已启动SSH服务（部分镜像默认开启）
2. 在VSCode中安装"Remote - SSH"扩展
3. 打开命令面板，选择"Remote-SSH: Connect to Host"，输入ssh [用户名]@localhost -p 2222（默认用户通常为vscode或root）

环境变量配置说明

Docker Compose配置示例

创建docker-compose.yml文件管理多环境配置：

yaml
version: '3.8'
services:
  golang-dev:
    image: [镜像名称]:[标签]
    container_name: golang-vscode-dev
    volumes:
      - ./project:/workspace  # 本地项目目录挂载
      - go-mod-cache:/go/pkg/mod  # Go模块缓存持久化
    ports:
      - "2222:22"  # SSH端口
      - "8080:8080"  # 应用调试端口（按需添加）
    environment:
      - GOLANG_VERSION=1.21
      - GOPROXY=https://goproxy.cn,direct
      - GOPATH=/workspace/go
      - GO111MODULE=on
    restart: unless-stopped

volumes:
  go-mod-cache:  # 声明模块缓存卷

启动命令：docker-compose up -d

扩展工具安装指南

容器内默认包含基础工具，如需添加额外组件：

1. 进入运行中的容器：

   bash
   docker exec -it golang-vscode-dev bash
   

2. 按基础系统类型安装工具：

   bash
   # Debian/Ubuntu基础镜像
   apt update && apt install -y [工具名称]
   
   # Alpine基础镜像
   apk add --no-cache [工具名称]
   

3. 常用工具安装示例：

   bash
   # 代码检查工具
   go install golang.org/x/lint/golint@latest
   
   # 代码格式化工具
   go install golang.org/x/tools/cmd/goimports@latest