composer找不到composer.json根本不是文件丢失，而是严格依据pwd输出的当前工作目录查找；必须先pwd确认路径、ls验证文件存在及权限，或用-d参数指定含该文件的目录且须置于子命令前。
执行 composer install 时提示找不到 composer.json
根本不是文件丢了，而是 Composer 只认当前工作目录（pwd 输出的路径）下有没有 composer.json。你在子目录（比如 src/ 或 api/）直接敲 composer install，它就去那个子目录里找，当然找不到。
常见错误现象：Could not find a composer.json file in /path/to/your/project/src —— 错误信息里写的路径，就是它真正在查的地方，不是你“以为”的项目根目录。
- 先运行
pwd，看清终端当前在哪 - 再运行
ls -l composer.json，确认文件存在且权限正常（至少-rw-r--r--） - 如果项目是 monorepo 或含子模块，用
find . -maxdepth 3 -name "composer.json"扫一遍，别误入错层
想在子目录执行但指向根目录的 composer.json？用 -d 参数
-d（等价于 --working-dir）是唯一合法、不依赖 cd 的方式，但它对参数位置和路径格式极其敏感。
正确写法：composer -d /path/to/project install（-d 必须放在子命令 install 前面）
- 路径必须是**含
composer.json的目录**，不能是文件路径（❌-d /path/to/project/composer.json） - 相对路径受当前 shell 位置影响：你在
/home/user下执行composer -d myapp install，它查的是/home/user/myapp/composer.json - 容器或 WSL 环境中，
$(pwd)挂载后可能和实际路径不一致，建议用绝对路径传给-d
为什么 composer install -d ./project 报错“Unknown option”？
因为 -d 是全局选项，不是 install 子命令的专属参数。放错位置就会被当成 install 的参数处理，而 install 不认识 -d，于是报 Unknown option d。
错误写法：composer install -d ./project（-d 在 install 后）
正确顺序只有这一种：composer -d ./project install（-d 在子命令前）
其他类似参数如 --no-interaction、--quiet 也一样——只要不是 install 自己定义的选项，都得放在子命令前面。
文件存在却仍报错？检查 BOM、软链接和挂载限制
Linux/macOS 下 ls 能看见、cat 能读，不代表 Composer 能解析。跨环境或编辑器保存不当容易埋坑。
-
composer.json是 UTF-8 with BOM（常见于 Windows 记事本）：用file -i composer.json查，输出含charset=bom就要重存为纯 UTF-8 - 项目目录是软链接（
ln -s），而composer.json在目标路径里：某些 CI 或容器环境禁止跨挂载点访问，realpath失败导致跳过 - Git 克隆漏了
--recursive，子模块里的composer.json根本没拉下来
这些情况都不会报“编码错误”或“符号链接失败”，只安静地报“找不到 composer.json”——最稳的办法永远是先 pwd + ls，再排查深层原因。
