composer install报“不支持的命令行选项”，90%是Composer版本过低（如1.x）不支持--ignore-platform-reqs等参数，需升级至2.0+并验证composer --version。
composer install 报“不支持的命令行选项”？先看 Composer 版本
报这个错，90% 是用了 composer install 命令里带了旧版不支持的参数，比如 --ignore-platform-reqs 在 Composer 1.x 中根本不存在（它从 2.0 才正式引入），而你本地装的还是 1.10.22 —— 不是拼写错，是压根没这功能。
验证方式很简单：composer --version。如果输出带 1.x，所有带 --ignore-platform-req* 的参数都会被无视并报错；只有 2.0+ 或 2.5+（推荐）才完整支持这些开关。
- Composer 1.x：只支持
--no-dev、--dry-run、--prefer-dist等基础选项，--ignore-platform-reqs会直接提示“unrecognized option” - Composer 2.0+：支持
--ignore-platform-reqs和--ignore-platform-req=xxx，但注意--ignore-platform-req（单数）在 2.2+ 才稳定，2.0~2.1 有 bug，可能静默失效 - 升级命令：
composer self-update（全局升级）或php composer.phar self-update（局部）
composer.json 里写了 "platform" 却没生效？语法位置和大小写必须严丝合缝
config.platform 只在 composer update 时起作用，对 install 完全无效——但它本身也极容易配错。常见错误是把它写在顶层，或者扩展名漏了 ext- 前缀。
正确写法必须满足三点：
- 必须嵌套在
"config": {}对象内，不能平级写在composer.json根目录 - 扩展名要和
php -m输出完全一致：ext-posix✅，posix❌，ext-POSIX❌ - PHP 版本字段写成
"php": "8.1.0"比"php": "^8.1"更稳妥，避免语义化版本解析歧义
改完后别忘了执行 composer update --lock，否则 composer.lock 还是按旧规则锁的，install 时照样报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
报错信息里出现 “Unknown option” 却不是参数名问题？检查是否混用了全局和项目级配置
有时候你确定参数没错、版本也够新，但依然报“Unknown option”，很可能是命令执行路径不对：你在项目外运行了 composer install，而当前目录下没有 composer.json，Composer 就会 fallback 到全局行为，并尝试解析全局配置里的非法字段（比如老版本 config.json 里手动加了 "ignore-platform-reqs": true）。
排查步骤：
- 进项目根目录再跑：
cd /path/to/project && composer install - 检查有没有残留的全局错误配置：
composer config -g --list | grep -i platform - 临时清掉全局 config 中的非法项：
composer config -g --unset config.platform.php（如果存在） - 确认当前目录下
composer.json和composer.lock都存在且未被 Git 忽略
CI 流水线里 install 失败，但本地能过？平台声明和锁文件生成环境不一致
CI 报“不支持该平台”，往往不是 CI 环境缺扩展，而是 composer.lock 文件是在 Windows 或 PHP 8.3 环境下生成的，而 CI 跑的是 Linux + PHP 8.1 —— 锁文件里记录的包版本依赖了某个平台特定扩展，但 CI 环境没声明兼容性。
真正可靠的解法不是在 CI 里加 --ignore-platform-reqs，而是：
- 确保
composer.lock是用目标平台（如 Linux + PHP 8.1 + ext-gd,ext-curl）生成的 - CI 脚本开头显式设置平台：
composer config platform.php 8.1.0，再执行composer install - 禁止在 CI 中执行
composer update，除非你明确想更新锁文件 - 如果项目必须跨平台开发，把
config.platform写死在composer.json里，而不是靠开发者本地配置
最常被忽略的一点：composer.lock 不是“一次生成，到处通用”的快照，它是带平台上下文的——换环境就得重生成，否则 install 就是拿旧契约硬套新环境。
