Docker Compose配置：实现.env.local优先覆盖默认.env且不提交至Git的方法

当然可以实现这个需求！Docker Compose本身就支持按顺序加载环境变量文件，而且会自动忽略不存在的文件，正好完美匹配你的场景。下面是具体的实现步骤：

1. 配置docker-compose.yaml的环境变量加载顺序 #

在你的docker-compose.yaml中添加env_file字段，指定先加载默认的.env文件，再加载.env.local文件。这样如果.env.local存在，其中的变量会覆盖.env里的同名变量；如果.env.local不存在，Compose会自动跳过它，直接使用.env的配置。

示例docker-compose.yaml代码：

version: '3.8'
services:
  # 替换成你的实际服务名称和配置
  app:
    image: your-app-image:latest
    ports:
      - "8080:8080"
    # 指定环境变量文件加载顺序
    env_file:
      - .env
      - .env.local
    # 其他服务配置（比如依赖、卷挂载等）...

2. 创建默认的.env文件 #

在Git仓库根目录创建.env文件，写入所有默认的环境变量，这个文件会被提交到仓库，作为所有用户的基础配置模板。

示例.env内容：

# 数据库配置
DB_HOST=db
DB_PORT=5432
DB_USER=default_user
DB_PASSWORD=default_password

# 应用配置
APP_PORT=8080
APP_DEBUG=false

3. 配置.gitignore忽略.env.local #

在仓库根目录的.gitignore文件中添加.env.local，确保这个本地自定义配置文件不会被提交到Git仓库：

示例.gitignore片段：

# 忽略本地环境变量文件，避免提交自定义配置
.env.local

# 其他需要忽略的文件（比如Docker日志、临时文件等）...
docker-compose.override.yaml
*.log

原理说明 #

Docker Compose加载env_file列表时遵循以下规则：

• 按列表顺序依次读取文件，后面文件中的同名变量会覆盖前面文件的变量
• 如果指定的文件不存在，Compose不会抛出错误，而是直接跳过该文件

这就意味着：

• 新用户克隆仓库后，无需任何额外配置，直接运行docker-compose up就能使用.env里的默认参数
• 有自定义需求的用户，只需创建.env.local并修改需要覆盖的变量即可，不会影响仓库的默认配置，也不会提交自己的自定义参数

实用提示 #

如果用户想基于默认配置快速创建本地自定义文件，可以运行以下命令：

# 复制默认.env作为本地配置模板
cp .env .env.local
# 然后用编辑器修改.env.local中的变量
nano .env.local

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