Composer install报“unknown option”因参数位置或组合错误：--repository-url仅update/require支持，--no-dev须紧随install后；镜像配置静默失效常见于键名错误、URL缺斜杠或项目级repositories覆盖全局配置。
不是命令写错，是参数位置或组合违反 Composer 解析规则——composer install 后面不能直接跟 --repository-url，也不能把 --no-dev 放在命令最前面。
composer install 报 “unknown option” 怎么定位？
错误通常出现在参数顺序错、拼写错、或混用了不同命令的开关。Composer 不是所有参数都全局通用，每个子命令只认自己定义的选项。
-
composer install --repository-url=https://xxx❌：这个参数只被update和require支持，install直接报错 -
composer --no-dev install❌：全局参数（如--help、--version）必须在子命令前，但--no-dev是install的专属参数，必须紧贴子命令后 -
composer install --prefer-dist --no-autoloader --no-scripts --no-dev✅：所有参数都在install后，且都是它合法接受的
镜像配置失败却没报错？检查三处静默失效点
配置命令看似成功，但 composer install 仍连 packagist.org，大概率是这三处之一出问题，且不提示错误：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名写成
repos.packagist（多一个 s）或repository.packagist→ Composer 忽略，不报错，也不生效 - URL 少了末尾
/，例如写成https://mirrors.aliyun.com/composer→ 部分版本会 404 后静默 fallback 到官方源 - 项目根目录
composer.json里有"repositories"字段 → 全局配置被完全覆盖，哪怕只写了{"packagist.org": false}
怎么验证当前真的在走镜像？别信 config 输出，要看真实请求
composer config -g repo.packagist 只显示“你写了什么”，不代表“它正在用”。真正有效的验证方式是触发一次网络请求并抓 URL：
- 先清缓存：
composer clear-cache - 执行带详细日志的命令：
composer require monolog/monolog -vvv 2>&1 | grep "GET\|Downloading" - 观察输出中是否含
mirrors.aliyun.com或mirrors.cloud.tencent.com；如果出现packagist.org或repo.packagist.org，说明镜像未接管 - 顺手跑
composer diagnose，若输出仍有Repo packagist.org is default，基本可断定配置无效
最容易被忽略的是：项目级 repositories 配置和全局配置共存时，前者永远胜出——哪怕你只是在 composer.json 里加了一行空数组，也足以让阿里云镜像形同虚设。
