composer 默认仅在当前工作目录查找 composer.json，不递归向上；使用 -d 可指定目录，composer 环境变量仅修改文件名而非路径；二者可共存，-d 优先级更高。
composer 命令默认在哪找 composer.json
它只在当前工作目录下找 composer.json，不递归向上查找，也不读取环境变量或全局配置来跳转目录。你执行 composer install 时 pwd 是哪，它就认哪为项目根目录。
常见错误现象：Command "install" is not defined. 或提示找不到 composer.json，其实只是你 cd 进错了目录，或者误以为它会自动识别子目录里的项目。
- 别依赖 IDE 自动打开的路径——终端 pwd 才算数
- 如果项目在
./backend，必须先cd ./backend再运行命令 -
composer --working-dir不是标准选项，官方不支持
用 -d 参数临时切换 composer 工作目录
-d（即 --directory）是 composer 唯一原生支持的“指定运行目录”方式，它会让 composer 把目标路径当作当前目录来加载 composer.json 和执行操作。
使用场景：脚本中批量处理多个项目、CI/CD 流水线里避免频繁 cd、或者你不想离开当前 shell 路径。
- 正确写法：
composer -d ./api install—— 这等价于先cd ./api再composer install - 路径必须存在且含
composer.json，否则报错：Could not open input file: ./api/composer.json - 相对路径和绝对路径都行，但注意 shell 展开时机：建议用引号包裹含空格或变量的路径，比如
composer -d "$PROJECT_PATH" update
COMPOSER 环境变量能改什么、不能改什么
这个变量只控制 composer.json 的**文件名**，不是路径。设成 COMPOSER=my-composer.json 后，composer 会在当前目录找这个名字的文件，而不是默认的 composer.json。
容易踩的坑：很多人误以为 COMPOSER=/path/to/composer.json 就能切目录，实际它只会让 composer 在当前目录下找这个「文件名」，路径部分会被忽略。
- 想换目录，请用
-d；想换文件名，才用COMPOSER - 两者可共存：
COMPOSER=other.json composer -d ./legacy install表示在./legacy下找other.json - 环境变量设置后对整个命令生效，包括插件和脚本调用
为什么不用 alias 或封装脚本替代 -d
alias 如 alias cda='cd ./app && composer' 看似方便，但它改变的是 shell 的当前目录，后续命令仍在此处执行，容易污染上下文；而封装脚本若没正确传递参数（比如忘记 "$@"），会导致 composer update --dry-run 这类带 flag 的命令失效。
性能与兼容性影响很小——-d 是 composer 内置逻辑，启动时直接 chdir，无额外进程或解析开销。
- CI 中推荐直接写
composer -d "$APP_DIR" install --no-interaction，清晰、可复现、不依赖 shell 状态 - 本地开发偶尔用没问题，但别把它当“永久配置”——composer 没有全局工作目录概念
- 注意 Windows 下路径分隔符不影响
-d，composer -d ".\src" dump-autoload可用，但统一用/更稳妥
真正要注意的，是 -d 不会改变 vendor/ 的生成位置逻辑——它仍按 composer.json 里 config.vendor-dir 配置来建目录，而该配置默认是相对 composer.json 所在路径的。
