报“no configuration file provided”是因为当前目录缺少docker-compose.yml或compose.yaml；需确认文件存在、命名准确，或用-f指定路径。
docker compose config 报 “no configuration file provided: not found” 怎么办
这不是 Docker Desktop 的 bug，而是当前工作目录下压根没找到 docker-compose.yml 或 compose.yaml。Docker Compose 默认只在当前目录（.）里找这两个文件名，不递归、不猜测、不 fallback。
常见错误现象：
- 你在项目子目录里执行
docker compose up，但docker-compose.yml其实在上层目录 - 你用的是
compose.yaml（新推荐格式），但误以为旧名才有效 - 文件名拼错，比如
docker-compose.yaml或docker-compose.yml.bak
实操建议：
- 先运行
ls -1 docker-compose.yml compose.yaml确认文件是否存在且命名准确 - 用
find . -maxdepth 2 -name "docker-compose.yml" -o -name "compose.yaml"向上两级搜一遍 - 如果找到了但不在当前目录，必须显式用
-f指定路径，例如：docker compose -f ../docker-compose.yml config - Windows 用户注意：PowerShell 的
ls不等价于 bash 的ls，建议在 Docker Desktop 自带的 WSL 终端或 Git Bash 中操作
为什么 docker compose config 不读 .env 文件里的变量
它会读，但前提是 .env 必须在执行命令的**当前目录**下，且文件编码是 UTF-8 无 BOM。Docker Compose 不会自动向上查找 .env，也不会读取子目录里的同名文件。
容易踩的坑：
-
.env放在./config/下，但你在./执行命令 → 变量不生效 - 用记事本保存了
.env→ 带 BOM，导致DB_HOST=127.0.0.1解析成DB_HOST=127.0.0.1 - 变量名含空格或特殊字符但没加引号：
API_URL=https://api.example.com/v1是合法的，但API_URL=https://api.example.com/v1/后面多一个空格就会让整个值变空
验证方式：
- 运行
docker compose config --no-interpolate | grep -A5 "environment:"，看原始变量名是否还在 - 再运行
docker compose config | grep -A5 "environment:"，对比是否已替换。若未替换，基本就是.env位置或格式问题
docker compose config 输出一堆内容，怎么快速定位服务定义
默认输出是完整合并后的 YAML，对中大型项目来说容易淹没关键信息。别直接肉眼扫，用管道过滤更可靠。
实操建议：
- 只看某服务的镜像和端口：
docker compose config | grep -A3 "^ web:" -B1（假设服务名叫web） - 提取所有
image:行并去重：docker compose config | grep "image:" | sort -u - 检查某个环境变量是否被正确注入：
docker compose config | sed -n '/^ api:/,/^ [a-z]/p' | grep DB_HOST（从api服务开始，到下一个服务名前为止） - 想保存渲染后配置做比对？用
docker compose config > rendered.yml，但注意这个文件不含注释，也不代表运行时实际行为（比如 healthcheck 的执行时机）
Windows Docker Desktop 下 compose.yaml 和 docker-compose.yml 能共存吗
能，但 Docker Compose **不会自动合并两者**。它只读一个：优先级是 compose.yaml > docker-compose.yml。如果两个都在当前目录，compose.yaml 会被选中，另一个被忽略。
使用场景：
- 你想保留旧的
docker-compose.yml做兼容，同时试用新格式 → 把旧文件改名（如docker-compose.yml.backup），再新建compose.yaml - 你有多个环境配置，不想混在一起 → 用
-f显式组合：docker compose -f docker-compose.yml -f docker-compose.override.yml config - 注意：Docker Desktop 的 GUI 界面（Containers / Dashboard）只识别通过
docker compose up启动的服务，不解析单独存在的配置文件
最常被忽略的一点：Docker Desktop 本身不“管理”配置文件位置，它只是调用 CLI。所谓“找不到”，本质是 CLI 在当前 shell 工作路径下没命中文件名规则 —— 这个路径可能和资源管理器里看到的“项目文件夹”不是一回事，尤其当你从快捷方式或 VS Code 集成终端启动时。
