Composer启动时按优先级顺序读取项目composer.json的config字段、COMPOSER_HOME/config.json及内置默认值，不支持--config等运行时指定配置文件。

composer 命令不支持运行时用 --config、-c 或其他参数指定任意配置文件路径。这不是功能缺失，而是设计如此——它的配置加载逻辑是硬编码的，只认固定位置的文件。

---

composer 启动时读哪些配置文件？

composer 启动时会按顺序检查并合并以下三类配置（优先级从高到低）：

• 项目根目录下的 composer.json 中的 config 字段
• 全局配置文件：COMPOSER_HOME/config.json（路径由 COMPOSER_HOME 环境变量决定）
• 内置默认值（不可覆盖）

注意：它不会读取你传入的某个 my-config.json，也不会响应类似 composer install --config=xxx 的写法——这种命令会直接报错：Unrecognized option "--config"。

---

为什么 COMPOSER_HOME 是唯一可控入口？

因为这是 Composer 唯一允许你“换掉整个全局配置根目录”的方式。改了它，就等于把 auth.json、config.json、缓存目录等全部迁移过去。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• Linux/macOS：export COMPOSER_HOME="/path/to/my-composer"（临时）
• Windows PowerShell：[Environment]::SetEnvironmentVariable("COMPOSER_HOME", "D:\my-composer", "User")
• 验证是否生效：composer config --global home 应输出你设的路径

⚠️ 重要提醒：

• COMPOSER_HOME 改了之后，auth.json 和 config.json 不会自动复制过去
• 如果目标目录下没有 auth.json，私有包安装会静默失败或报 Could not authenticate
• 项目级配置（如 repositories）仍以项目 composer.json 为准，不受 COMPOSER_HOME 影响

---

怎么让某个项目“完全无视全局配置”？

不是切换配置文件，而是剥离全局影响：

• 临时重命名全局配置：mv ~/.composer/config.json ~/.composer/config.json.bak
• 检查项目 composer.json 是否含 repositories 字段（它会覆盖全局镜像）
• 若需认证，把 auth.json 内容移到项目根目录，并确保未被 Git 提交（否则泄露凭据）
• 运行 composer diagnose，确认 “Repo:” 行显示的是你预期的源地址

真正的控制点不在参数，而在环境变量和文件存在性。漏掉 auth.json 或误删 repositories 字段，比记错命令更常导致问题。