运行docker-compose build报错：未找到配置文件，但文件已存在

以下是针对该问题的排查和解决步骤：

• 检查配置文件名：Docker Compose默认仅识别docker-compose.yml或docker-compose.yaml格式的文件。如果你的配置文件名不符合这个规则，需要通过-f参数指定文件路径，例如：

  docker-compose -f custom-compose.yml build
  

  可执行ls（Linux/macOS）或dir（Windows）命令，确认当前目录下的配置文件名是否正确。

• 确认当前工作目录：执行pwd（Linux/macOS）或cd（Windows）命令，检查终端当前路径是否与配置文件所在目录一致，避免因路径错误导致文件无法被识别。

• 检查文件权限（Linux/macOS环境）：若配置文件权限不足，Compose可能无法读取文件内容。执行以下命令赋予文件可读权限：

  chmod 644 docker-compose.yml
  

• 验证配置文件合法性：即使文件存在，YAML语法错误也可能引发异常提示。执行以下命令验证配置文件格式：

  docker-compose config
  

  该命令会解析配置文件并输出结果，若存在语法问题会直接报错。

• 使用Compose V2推荐命令：你当前使用的是Docker Compose V2，官方推荐使用无横杠的命令格式，尝试替换为：

  docker compose build
  

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