运行Composer install报错提示未知选项？命令行参数校验-composer-PHP中文网

composer install报“unknown option”是因为传入了该命令不支持的参数，如--archive-dir或--repository；它仅支持--no-dev、--optimize-autoloader等有限选项，其他参数需通过composer config提前配置。

运行composer install报错提示未知选项？命令行参数校验

composer install 报 “Unknown option” 是因为传了它根本不认的参数

Composer 的 install 命令不支持任意自定义选项，所有合法参数都硬编码在源码里。一旦你写了 composer install --archive-dir=/path 或 --repository=https://xxx 这类命令，就会直接报 Unknown option 错误——不是配置错，是根本没这个开关。

常见错误写法：

composer install --archive-dir=/tmp/archives → Unknown option archive-dir
composer install --repository=https://mirrors.aliyun.com/composer/ → Unknown option repository
composer install -v --force → Unknown option force（--force 只在 update 里有效）

原因很直接：install 命令只接受有限几个参数，比如 --no-dev、--optimize-autoloader、--dry-run 等，其余统统被拒绝。它不像 create-project 或 require 那样支持临时仓库或路径覆盖。

哪些参数 `install` 真的能用？看官方文档比猜安全

截至 2026 年 8 月，composer install 明确支持的选项只有这些（运行 composer install --help 可验证）：

--no-dev：跳过 require-dev 里的包
--optimize-autoloader：生成 classmap，提升加载速度
--classmap-authoritative：配合 --optimize-autoloader，让 autoloader 完全信任 classmap
--dry-run：模拟执行，不真正写文件
--ignore-platform-reqs：绕过 PHP 版本、扩展等平台检查（慎用）
--no-scripts：跳过 post-install-cmd 等钩子

注意：--repository 和 --archive-dir 不在其中。前者只对 create-project 和 require 有效；后者必须通过 composer config archive-dir /path 写入配置，且路径基于项目根目录解析。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

想改 archive-dir 或镜像源？别往 install 上硬塞参数

需要修改归档路径或镜像源，得提前设好配置，而不是在 install 命令里加参数：

设 archive-dir：composer config archive-dir ./archives（写入当前项目 composer.json 的 config 字段）
设全局镜像：composer config -g repo.packagist https://mirrors.aliyun.com/composer/（写入 ~/.composer/config.json）
设项目级镜像：composer config repositories.packagist.type composer + composer config repositories.packagist.url https://mirrors.aliyun.com/composer/