用变量插值提升 docker compose 灵活性，核心是将镜像版本、端口、数据库连接等高频变动项交由 ${var} 管理，配合 .env 文件统一配置、${var:-default} 设默认值、${var:?msg} 强制校验，并通过多文件合并与变量优先级实现多环境适配。
用变量插值让 Docker Compose 文件灵活通用，关键不是堆功能，而是把变量用在该用的地方——镜像版本、端口、数据库连接、环境标识这些高频变动项，全交给 ${VAR} 管理，配合默认值和校验，就能一套配置跑遍开发、测试、生产环境。
核心变量统一放 .env 文件
项目根目录建一个 .env 文件，集中定义所有可变参数。它自动被 Compose 加载，无需额外命令：
-
格式简单：每行 KEY=VALUE，支持 # 注释，不支持空格（
PORT=8080✅，PORT = 8080❌） -
内容示例：
APP_VERSION=1.2.0 DB_HOST=postgres DB_PORT=5432 HOST_PORT=3000 ENV_TYPE=staging
-
安全提醒：.env 必须加入
.gitignore，尤其避免误传密码、密钥等敏感信息
YAML 中用 ${VAR:-default} 设默认值
不是所有环境都配全变量，硬写 ${VAR} 会报错；加 :-default 就能兜底，既健壮又免改配置：
-
image: nginx:${NGINX_VERSION:-alpine}→ 未设 NGINX_VERSION 时用 alpine 镜像 -
ports: - "${HOST_PORT:-3000}:80"→ 本地开发默认映射 3000，CI/CD 可覆盖 -
environment: NODE_ENV: ${ENV_TYPE:-development}→ 容器内自动获知运行阶段 - 注意：
${VAR:-default}在 VAR 为空或未定义时都生效；${VAR-default}仅在未定义时生效（空字符串也算已定义）
关键变量用 ${VAR:?msg} 强制校验
有些变量绝不能漏，比如数据库密码、API 密钥。用 :?error 语法，启动前就报错，不带侥幸：
POSTGRES_PASSWORD: ${DB_PASSWORD:?请在 .env 中设置 DB_PASSWORD}image: myapp:${RELEASE_TAG:?必须指定发布标签}- 错误信息清晰直给，省得排查“为什么容器起不来”，其实是变量没填
多环境靠文件合并 + 变量分层
单个 docker-compose.yml 不够用？用 -f 合并多个文件，再靠变量区分行为：
- 基础文件
docker-compose.yml写通用服务结构，只用变量（如${IMAGE}、${PORT}） - 环境覆盖文件
docker-compose.prod.yml设置生产专用变量：services: app: environment: - NODE_ENV=production deploy: replicas: 3 - 启动命令：
docker compose -f docker-compose.yml -f docker-compose.prod.yml up - 变量优先级：命令行 > env_file > .env > 默认值，确保上线时能用
--env-file prod.env覆盖全部
