低代码平台部署时，环境变量如何自动适配不同环境？

低代码平台部署时自动适配不同环境的环境变量配置问题，确实是很多开发者在使用 Docker 和 docker-compose 时会遇到的痛点。我来给你一步步讲清楚怎么解决这个问题，顺便告诉你为什么这样设计会更高效。

首先你要明白，环境变量的核心作用是让同一个应用在不同环境（开发、测试、生产）中能动态使用不同的配置。你现在的做法是直接在 docker-compose.yml 里引用 .env 文件里的变量，这种方式虽然简单，但缺乏灵活性，尤其是在 CI/CD 场景下，容易出错。

我们来换个更灵活的方式：

第一步：使用多个 .env 文件区分不同环境

你可以创建多个环境变量文件，比如：
.env.dev
.env.test
.env.prod

每个文件里面写对应环境的变量，比如 .env.prod 里面写：

API_URL=https://api.prod.example.com
DATABASE_HOST=prod-db.example.com

第二步：修改 docker-compose.yml 的写法，让它支持传入不同的 .env 文件

你现在的写法是硬编码 environment 里用 ${API_URL}，这样会默认从当前 shell 或默认的 .env 里取值。我们可以换个写法，让 docker-compose 支持从不同路径加载 .env 文件。

修改你的 docker-compose.yml 文件：

version: '3'
services:
your-app:
image: your-image
env_file:
- ${ENV_FILE_PATH:-.env} # 这里表示如果没传 ENV_FILE_PATH，就用 .env
environment:
- API_URL=${API_URL}
- DATABASE_HOST=${DATABASE_HOST}

这段配置的意思是：优先使用你传入的 ENV_FILE_PATH，如果没有传，就用默认的 .env 文件。

第三步：运行时通过命令行传入对应的 .env 文件路径

你可以在启动容器的时候，直接指定 ENV_FILE_PATH，比如：

启动测试环境：
ENV_FILE_PATH=.env.test docker-compose -f prod.yml up

启动生产环境：
ENV_FILE_PATH=.env.prod docker-compose -f prod.yml up

这样就不需要每次手动改 docker-compose.yml 或者手动替换 .env 文件了，完全通过命令行参数控制。

第四步（可选）：结合 CI/CD 工具自动化部署

如果你用的是 Jenkins、GitLab CI 或 GitHub Actions，可以在部署脚本里加上环境判断逻辑，自动选择对应的 .env 文件。比如在 GitHub Actions 的 workflow 文件里写：

jobs:
deploy:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2

- name: Set environment file
run: |
if [ "${{ github.ref }}" == "refs/heads/main" ]; then
echo "ENV_FILE_PATH=.env.prod" >> $GITHUB_ENV
else
echo "ENV_FILE_PATH=.env.test" >> $GITHUB_ENV
fi

- name: Deploy with docker-compose
run: docker-compose -f prod.yml up -d

这个脚本的意思是：如果是 main 分支就用生产环境的配置，否则用测试环境的配置。

总结一下：

整个方案的核心思想是：通过环境变量控制 docker-compose 使用哪个 .env 文件，从而实现不同环境的自动配置。这种方式不仅适合本地开发，也适合自动化部署流程，避免了手动修改配置带来的错误风险。

如果你还想进一步优化，可以考虑把环境变量集中管理起来，比如用 HashiCorp Vault 或者 AWS SSM Parameter Store，但那是更高阶的玩法了。先把这个方案吃透，足够应付绝大多数场景了。

有问题再来问我，我随时在。

我们之前也遇到类似的问题，后来是通过结合 Docker Compose 的 env_file 和环境变量传参实现的。你可以试试下面这个方法：

创建多个 .env 文件，比如 .env.prod 和 .env.test，里面分别写上生产环境和测试环境的变量：

API_URL=http://your-api.com

   DATABASE_HOST=prod-db-host

在 docker-compose.yml 里不要固定写死 .env 文件，而是动态传参进去：

environment:

     - API_URL

     - DATABASE_HOST

   env_file:

     - .env.${DEPLOY_ENV}

部署时通过命令行传参指定环境：

DEPLOY_ENV=test docker-compose -f prod.yml up

或者生产环境：

DEPLOY_ENV=prod docker-compose -f prod.yml up

这样就能根据 DEPLOY_ENV 动态加载不同的 .env 文件，而不用手动改配置文件了。如果某些变量需要覆盖，也可以直接在命令行加 -e 参数临时传入，Docker 会优先使用这些值。

我们后来还把这套逻辑集成到 CI/CD 脚本里，直接通过 Jenkins 或 GitLab CI 的变量控制环境，省得手动输入。希望能帮到你！