根本原因是 composer 版本与配置键名不匹配或被更高优先级配置覆盖，且未清缓存、项目级 repositories 字段存在时会屏蔽全局设置。
composer config -g repo.packagist 为什么没生效
根本原因不是命令写错了，而是 Composer 版本和配置键名不匹配，或被更高优先级的配置覆盖了。
-
repo.packagist是 Composer 1.x 和 2.x 都支持的键名，但新版（2.2+）更推荐用repositories.packagist.org；不过只要 URL 格式正确、末尾带/，repo.packagist依然有效 - 项目根目录下的
composer.json中只要存在"repositories"字段（哪怕空数组、哪怕只写了{"packagist.org": false}），就会完全屏蔽全局设置 - Windows 下用 Git Bash 时，
COMPOSER_HOME环境变量可能未生效，实际读取的是%APPDATA%\Composer\config.json，而不是~/.composer/config.json - 执行完命令没清缓存：
composer clear-cache必须做，否则旧的packages.json元数据还在本地，install 仍会连错源
全局切换到阿里云/腾讯云镜像的正确命令
别手动改 JSON，别猜路径，直接用 composer config 写入，确保键名、类型、URL 三者都合规。
- 设阿里云源（兼容性优先）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 设腾讯云源（fallback 更友好）：
composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 华为云源：
composer config -g repo.packagist composer https://mirrors.huaweicloud.com/repository/php/ - 所有 URL 结尾必须带
/，否则会拼出https://mirrors.aliyun.com/composerpackages.json导致 404 - 验证是否写入成功：
composer config -g repo.packagist.url应输出对应镜像地址；composer diagnose的 “Repo:” 行也得匹配
项目级配置覆盖全局时怎么临时绕过
有些 Laravel 脚手架或私有模板自带 composer.json，硬编码了官方源或禁用了 packagist，导致全局配置彻底失效。
- 检查当前项目是否有
"repositories"字段：grep -A5 repositories composer.json - 临时清除项目级配置：
composer config --unset repositories（注意没-g） - 不想删配置？可显式重定向：
composer config repo.packagist composer https://mirrors.ustc.edu.cn/composer/（覆盖原字段） - 初始化新项目时被卡住：
composer create-project laravel/laravel demo --repository-url=https://mirrors.aliyun.com/composer/
composer global require 还是走官网？
因为 composer global 用的是全局项目（~/.composer/composer.json）的配置，它和全局配置文件（~/.composer/config.json）是两套独立系统。
- 你对
config.json执行了composer config -g，但~/.composer/composer.json里没配镜像，global require就会 fallback 到官方源 - 解决方法：进
~/.composer目录，再执行一次：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证：
composer global show -s查看当前全局项目的仓库设置 - 某些 CI 环境下，建议统一用腾讯云源：
https://mirrors.cloud.tencent.com/composer/，它的 fallback 行为能避免因镜像同步延迟导致构建失败
最常被忽略的其实是缓存和项目级 repositories 字段——换源后不 clear-cache，或者不检查 composer.json 里有没有硬编码源，等于白配。
