composer 配国内镜像需同时满足三点：键名必须为 repo.packagist，type 值必须写 composer，url 必须是 https 且末尾带斜杠；全局配置需对实际运行用户生效；换源后需删除 vendor 和 composer.lock 重装。
composer config -g repo.packagist 命令必须写对三个关键点
国内用 Composer 不配镜像，composer install 卡在 Downloading 或报 could not find package 是常态，不是网络问题，而是还在直连 packagist.org。命令必须同时满足以下三点，缺一不可：
-
repo.packagist是唯一有效键名 —— 写成repos.packagist（多一个 s）或packagist（少 repo.）都会静默失效 - 中间那个
composer是 type 值，不能省：正确是composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，http://❌，https://mirrors.aliyun.com/composer（缺斜杠）❌
验证是否生效：运行 composer config -g repo.packagist，输出应为完整 URL 字符串或 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍是 https://packagist.org，说明没写进去。
宝塔、Docker、CI 环境中全局配置常不生效
你在终端用 root 执行了 composer config -g，但宝塔后台部署是以 www 用户运行的，它读的是 /home/www/.composer/config.json，根本看不到 root 的配置。同理，GitHub Actions 用 runner 用户，Docker 容器里默认是 www-data 或自定义用户。
- 查实际执行用户：宝塔终端里运行
whoami，再切过去验证composer config -g repo.packagist - 重配需用对应用户：如
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中避免依赖全局配置，改用临时参数更可靠：
composer install --repository=https://mirrors.aliyun.com/composer/
项目级配置比全局更可控，但要注意 repositories 格式
进项目根目录后运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），会自动往 composer.json 的 repositories 字段安全追加，不覆盖已有私有源。但前提是 repositories 当前是对象（{}），不是数组（[]）——否则命令会报错。
- 若
composer.json已有"repositories": []，先手动改成"repositories": {}再执行命令 - 千万别手写
"packagist": false，这会彻底关掉基础包源，导致monolog/monolog等核心包拉不到 - 改完必须删掉
vendor/和composer.lock，否则旧 lock 文件里的 hash 可能和镜像元数据不匹配
换镜像后仍卡在 Resolving dependencies？和镜像无关
镜像只加速下载环节，Resolving dependencies 阶段完全本地运行，卡住说明问题出在环境或约束本身：
- PHP 内存不足：默认
128M不够，临时加COMPOSER_MEMORY_LIMIT=-1再试 - Xdebug 启用中：会让解析慢 5–10 倍，用
php -d xdebug.mode=off $(which composer) install临时禁用 -
platform配置与实际 PHP 版本不匹配：比如"php": "7.4"却在PHP 8.5.5上运行，触发降级查找逻辑 -
composer.json中版本约束太宽，如"*"或"^1.0 || ^2.0"，导致组合爆炸式尝试
真正容易被忽略的是：镜像生效后首次安装，如果 composer.lock 是之前直连官方源生成的，hash 校验大概率失败 —— 这时候删 lock 文件重来，不是 bug，是预期行为。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
