Docker Compose 不支持在服务名、网络名、卷名中直接使用 ${VAR} 模板语法实现前缀隔离，应通过 -p 或 COMPOSE_PROJECT_NAME 设置项目名，由 Compose 自动添加前缀；${COMPOSE_PROJECT_NAME} 仅可在 container_name、labels 等字段使用，不可用于 service/network/volume 键名。
在 Docker Compose 中，不能直接通过模板语法（如 ${PROJECT_PREFIX}）动态生成服务名、网络名或卷名的前缀来实现项目级隔离——但可以通过 Compose 的 project_name 机制 + 外部变量 + 命名约定 实现等效效果。关键在于：容器资源命名由 Compose 自动处理，而“前缀隔离”本质是靠 docker-compose -p 或 COMPOSE_PROJECT_NAME 控制，不是在 YAML 里硬编码前缀。
用 -p 或 COMPOSE_PROJECT_NAME 指定项目名
这是最标准、最可靠的方式。Compose 会自动将服务名、网络名、卷名等加上该项目前缀（默认是目录名），并加下划线分隔：
- 运行
docker-compose -p myapp-dev up，所有容器名变成myapp-dev-web-1、myapp-dev-db-1 - 对应网络名为
myapp-dev_default，卷名为myapp-dev_data（如果定义了data:卷） - 也可设环境变量：
COMPOSE_PROJECT_NAME=myapp-staging docker-compose up
在 docker-compose.yml 中引用项目名（需 v2.20+ / v2.23+）
新版 Compose 支持 ${COMPOSE_PROJECT_NAME} 变量（仅限部分上下文，如 container_name、labels、environment），但不适用于 service 名、network 名、volume 名本身（这些由 Compose 内部管理）：
- ✅ 可用于自定义容器名：
container_name: "${COMPOSE_PROJECT_NAME}-web" - ✅ 可用于标签或环境变量传递项目上下文：
labels: ["com.example.project=${COMPOSE_PROJECT_NAME}"] - ❌ 不能写
services: ${COMPOSE_PROJECT_NAME}-web:—— YAML 键名不支持变量插值
多环境隔离推荐实践
避免手动拼接前缀，用项目名 + 独立 compose 文件 + 显式网络/卷命名（可选）：
- 为不同环境准备独立目录（如
./prod/、./staging/），各放一份docker-compose.yml - 在 CI/CD 中统一用
docker-compose -p ${ENV_NAME}-${SERVICE_NAME} up启动 - 若需显式控制卷名，可在
volumes:下使用带前缀的自定义名：myapp-prod-data:，再在服务中引用；这样即使项目名变化，卷仍可复用 - 网络建议保持默认（
default），由项目名自动隔离；如需跨项目通信，才显式定义外部网络
不推荐的做法（易出错）
以下方式看似灵活，实则破坏 Compose 的资源管理逻辑：
- 在
services:下用container_name: "prefix-service"手动固定容器名 → 导致无法 scale、重启冲突、健康检查异常 - 用 shell 脚本预处理 YAML（如
envsubst docker-compose.yml）→ 增加构建步骤、丢失 Compose 原生变量能力、难以调试 - 在
networks:或volumes:中硬编码带变量的名称（如"${PREFIX}_net"）→ Compose 不解析，报错或忽略
