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，且其中应明确声明所需依赖、平台配置和仓库（如需）。
- 避免依赖全局 autoloader 或脚本 —— 所有
"autoload"、"scripts"、"require"都应在本地文件中定义 - 若使用私有包，优先通过项目级
"repositories"声明，而非全局配置 - 运行
composer validate确保语法正确，避免因格式错误导致 fallback 到全局行为
重置认证凭据到项目级
GitHub/GitLab 等 OAuth Token 若存于全局 auth.json，可能干扰私有包拉取逻辑。可改用项目级认证：
- 在项目根目录创建
auth.json（与composer.json同级） - 内容示例：
{"github-oauth": {"github.com": "your_token_here"}} - 运行
composer config --auth github-oauth.github.com your_token_here（该命令会自动写入项目级auth.json） - 注意：确保
.gitignore包含auth.json，避免敏感信息泄露
验证是否已回归本地模式
执行以下命令确认当前行为完全由项目驱动：
-
composer config --list --global：应仅显示极少数默认项（如home），无自定义配置 -
composer config --list（无--global）：只显示项目composer.json和本地auth.json中的设置 -
composer show --platform和composer depends vendor/package应仅反映本项目依赖图 - 删除
vendor/和composer.lock后重新composer install，全程不报全局相关警告
基本上就这些。Composer 本身是项目优先的工具，所谓“切换回本地”，本质是消除意外的全局干预，让 composer.json 重新成为唯一真相源。
