如何将 Composer 从全局配置切换回项目本地配置？

Composer 默认以项目根目录的 composer.json 为唯一配置源；所谓“全局配置”实为误读，常见于全局安装包、auth.json 或 COMPOSER_HOME/config.json 的干扰；应通过重命名全局 config.json、验证本地 composer.json、迁移认证至项目级 auth.json 等方式剥离全局影响，确保所有行为由本地文件决定。

Composer 默认会优先读取项目根目录下的 composer.json，所谓“全局配置”其实并不存在真正意义上的全局 composer.json；你可能遇到的是以下几种情况：全局安装了某些包（如 laravel/installer）、使用了全局的 auth.json、或误将配置写入了全局 config（COMPOSER_HOME/config.json）。要让项目完全回归本地控制，关键在于剥离全局影响，确保所有依赖、仓库、认证和行为都由项目自身的配置决定。

确认并清理全局 Composer 配置

全局配置文件通常位于：
– Linux/macOS：~/.composer/config.json
– Windows：%APPDATA%\Composer\config.json

检查该文件是否包含影响项目的设置，例如：

• "repositories"：可能覆盖了 packagist.org 或添加了私有源
• "config" 下的 "vendor-dir"、"bin-dir"、"github-oauth" 等
• "fxp-asset" 或其他已弃用插件相关配置

建议：临时重命名该文件（如 config.json.bak），再在项目中运行 composer install，观察是否恢复正常。若无异常，说明问题出在全局配置上。

确保项目 composer.json 完整且独立

项目根目录必须存在有效的 composer.json，且其中应明确声明所需依赖、平台配置和仓库（如需）。

标签： composer 本地配置 linux laravel js git json windows github app 工