使用godotenv时如何基于构建命令切换不同环境的env文件

方案合理性判断 #

你提到的通过构建参数指定对应env文件加载的思路是可行的，唯一需要调整的是Go原生go build没有--prod这类自定义参数，需要通过Go官方支持的编译时注入或构建标签能力实现。

具体实现步骤 #

• 第一步：代码中预留环境变量接收位
  在main包中定义全局环境标识变量，启动时根据变量值加载对应env文件：

package main

import (
  "fmt"
  "github.com/joho/godotenv"
)

// 编译时会注入该变量的值，默认走开发环境
var Env = "dev"

func main() {
  // 加载对应环境的配置文件
  err := godotenv.Load(fmt.Sprintf("%s.env", Env))
  if err != nil {
    panic("加载配置文件失败: " + err.Error())
  }
  // 后续业务逻辑
}

• 第二步：编译时注入环境标识
  通过go build的-ldflags参数注入变量值，示例：

# 生产环境构建
go build -ldflags "-X main.Env=prod" -o my-project .
# UAT环境构建
go build -ldflags "-X main.Env=uat" -o my-project .

• 第三步：Docker构建时传参切换
  在Dockerfile中通过ARG接收环境参数，自动适配构建：

# 基础镜像阶段省略
ARG ENV=dev
# 仅复制对应环境的配置文件
COPY ${ENV}.env .
# 编译时注入环境标识
RUN go build -ldflags "-X main.Env=${ENV}" -o my-project .

构建镜像时通过--build-arg指定环境即可：

docker build --build-arg ENV=prod -t my-project:prod .

避免无关env文件打入镜像的方法 #

• 配置.dockerignore文件排除所有env文件，从根源上避免无关文件进入构建上下文：

# .dockerignore文件内容
*.env

• 结合上文中Dockerfile的COPY ${ENV}.env .指令，仅会将指定环境的env文件复制到镜像中，其他环境的配置文件完全不会进入构建产物。
• 如果使用多阶段构建，只需在最终运行阶段复制编译好的二进制和对应env文件，构建阶段的所有临时文件都不会进入最终镜像，进一步减小镜像体积、避免配置泄露。

内容的提问来源于stack exchange，提问作者zer0