composer 1.x 不支持 --optimize-autoloader 长参数，仅识别 -o 缩写，且与 --no-dev 同用会报“unrecognized option”；2.x+ 才支持二者共存，需先执行 composer -v 确认版本并按对应语法使用。
composer install 后面跟了 --no-dev --optimize-autoloader 却报“unrecognized option”
这是 Composer 版本不兼容的典型表现：低版本（如 1.x）不支持 --optimize-autoloader，高版本（2.2+）才默认启用该功能，但旧脚本里硬写参数反而触发报错。
常见场景是 CI/CD 脚本沿用老项目模板，或本地 Composer 版本卡在 1.10.x —— 它只认 --optimize-autoloader 的缩写 -o，且不接受 --no-dev 和 --optimize-autoloader 同时出现（会报 unrecognized option）。
- 先确认版本：
composer -V；若输出类似Composer version 1.10.22，就别用长参数 - Composer 1.x 推荐写法：
composer install --no-dev -o - Composer 2.x+ 安全写法：
composer install --no-dev --optimize-autoloader（--no-dev和--optimize-autoloader可共存） - CI 环境建议统一升级：
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
执行 composer install --ignore-platform-reqs 却提示 “Command ‘--ignore-platform-reqs’ is not defined”
这不是参数拼错，而是把 --ignore-platform-reqs 放错了位置——它必须紧跟在 composer install 后面，不能插在中间或末尾，更不能当子命令用。
错误写法：composer install my-package --ignore-platform-reqs（my-package 是多余参数，install 不接受包名）
正确写法只有这一种：composer install --ignore-platform-reqs
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install是还原锁文件的确定性操作，不接受任何包名、版本号等额外参数 -
--ignore-platform-reqs是全局开关，不是某个包的修饰符 - 如果误写成
composer install --ignore-platform-reqs some/package，Composer 会把--ignore-platform-reqs当作子命令名解析，直接报 command not defined - 临时绕过平台检查只应在调试时用，生产环境应修复 PHP 版本或扩展缺失问题
composer install 报 “Command ‘install’ is not defined”
这说明当前运行的不是 Composer，而是别的同名工具（比如某 Docker 镜像里预装的简化版包管理器），或者 composer 命令被 alias 或 wrapper 覆盖了。
最常发生在：用 php composer.phar install 时路径写错，或系统 PATH 里存在冲突的二进制文件。
- 运行
which composer看实际调用路径；若输出/usr/local/bin/composer，再执行ls -l /usr/local/bin/composer确认是否为 Composer 官方 phar - 直接调用 phar 文件验证：
php /path/to/composer.phar install—— 如果成功，说明 PATH 中的composer是假的 - 检查是否有 alias：
alias composer；若有，用\composer install绕过 alias - 某些 IDE 自带的终端会注入自定义 PATH，换系统终端重试能快速排除干扰
composer install --dry-run --no-interaction 报错说参数不支持
--dry-run 是 Composer 2.5.0+ 新增参数，旧版本（包括所有 1.x 和 2.4.x）根本不识别它，报错就是意料之中。
这个参数本身很实用：它能提前暴露依赖解析失败、平台不匹配等问题，又不真正写文件，适合放进 CI 前置检查。
- 先查版本：
composer -V；低于 2.5.0 就别用--dry-run - 替代方案（兼容 1.x & 2.x）：
composer update --dry-run --no-interaction（效果接近，但语义略有差异） - 如果必须用
--dry-run，升级命令：composer self-update --2（强制升到最新 2.x） - 注意：
--dry-run不校验 autoload 路径是否存在，要额外跑composer dump-autoload --no-dev测试自动加载
实际部署时，最容易被忽略的是：不同 Composer 版本对同一参数的支持边界不一致，而错误信息又不提示版本要求。与其反复试错，不如在项目根目录加一行 composer.json 的 "config": {"platform-check": false}（仅限调试），或直接锁死 CI 中的 Composer 版本。
