首页/云/Docker 容器速查/compose 默认文件名与查找顺序
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose 默认文件名与查找顺序

Compose 默认按固定顺序查找编排文件:compose.yaml / compose.yml 优先于 docker-compose.yml / docker-compose.yaml;同目录存在多个候选会直接报错。

Docker 容器速查云更新于 2026-10-12
查找顺序compose.yaml → compose.yml → docker-compose.yml → docker-compose.yaml
多文件并存报 found multiple config files
指定文件-f 路径(可多次)

示例

示例
ls compose.yaml docker-compose.yml 2>/dev/null
# 报错示例:found multiple config files with supported names
docker compose -f compose.yaml config -q
新项目统一用 compose.yaml;从旧项目迁移时先删掉不再使用的另一个候选文件。

易错点

  • 目录里新旧两个文件并存时命令直接失败,看着像语法问题其实是文件选择歧义
  • 脚本未显式 -f 时行为依赖当前目录,CI 里建议固定文件路径

数据来源与参考

  • Docker 官方文档:Compose 文件查找规则(docs.docker.com/compose/compose-file)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌