Composer参数顺序错乱会导致静默失效：全局选项（如-d、--verbose）必须置于子命令前，否则被当作子命令参数忽略；正确写法为composer -d ./api install，错误写法composer install -d ./api会使-d不生效。
composer 命令参数顺序错乱导致静默失效
Composer 对子命令和全局选项的顺序极其敏感，-d、--no-interaction、--verbose 等参数如果放在子命令之后，会被当作该子命令的参数传入，而非 Composer 自身指令——结果就是参数完全不生效，还不会报错。
常见翻车写法：composer install -d ./api（-d 被当成 install 的参数）；正确写法必须是：composer -d ./api install。
-
-d、--working-dir、--no-plugins等全局开关，一律要置于子命令（如install、update、require）之前 -
--分隔符可用于显式终止选项解析，例如：composer run-script test -- --filter=unit，避免脚本参数被误读 - 不确定顺序时，用
composer help [command]查该命令的参数说明，注意 “Global Options” 和 “Options” 的分组位置
参数值类型不匹配引发报错或跳过
很多参数表面看是路径或字符串，但实际有严格格式要求。比如 -d 后必须跟「含 composer.json 的目录」，不是文件路径；--repository 必须是合法 JSON 或 URL，不能直接填本地文件名。
典型错误现象：Could not find a composer.json file in /xxx，但 ls /xxx/composer.json 明明存在——大概率是 -d 指向了 /xxx/composer.json（文件）而非 /xxx（目录）。
-
-d、--working-dir：值必须是目录路径，且该目录下必须存在可读的composer.json -
--repository：只接受完整 URL（如https://example.com/packagist）或内联 JSON（如'{"type":"composer","url":"…"}'），不支持file://或相对路径 -
--ignore-platform-req：值必须是扩展名（如ext-gd）或包名（如php），不能写成gd或php7.4
参数冲突导致行为异常
某些参数组合会互相覆盖或触发隐式逻辑，比如 --prefer-dist 和 --prefer-source 互斥；--no-dev 在 composer install 中默认启用，但加在 composer update 上却会强制剔除 require-dev 包——即使你只是想更新一个生产依赖。
另一个高频冲突点：--optimize-autoloader（-o）与 --classmap-authoritative（-a）不能共存，后者会覆盖前者的行为逻辑，且 Composer 不会警告，只会按后者语义执行。
-
composer install --no-dev -o是安全组合；但composer update --no-dev -a可能意外清掉开发时需要的工具包（如phpunit） -
--dry-run和--with-dependencies同时使用时，依赖解析仍会执行，但不会写入composer.lock——容易误判为“没变化”而跳过更新 - 调试时慎用
--quiet：它会吞掉关键提示（如镜像未生效、缓存命中等），反而掩盖参数是否起效
怎么快速验证参数是否真正生效
别信命令输出里有没有“Loading config”这种模糊提示，得看底层动作是否按预期发生。最直接的办法是加 -v 或 -vvv，然后 grep 关键字。
例如配了 -d ./app，就跑 composer -d ./app install -v 2>&1 | grep "Reading composer.json"，确认路径是否对；想查镜像是否走通，就 composer update -vvv 2>&1 | grep "Downloading.*packages.json"。
- 所有带
-v的命令，都会在日志里打印当前工作目录、配置加载路径（Reading /home/user/.composer/config.json）、仓库 URL、实际请求地址 - 若看到
Reading composer.json后路径不对，说明-d没生效或路径写错；若始终出现https://packagist.org/，说明镜像配置没加载成功 - 对全局参数（如
config -g）也要单独验证：composer config -g --list输出的是当前生效配置，不是你“以为”写进去的内容
参数问题最难缠的地方在于：它常常不报错，只是默默跳过、降级执行或读错位置。每次改完参数，务必用 -v 看一眼真实路径和请求地址，而不是只盯着“success”字样。
