composer config -g repo.packagist 不生效是因为三个硬性条件缺一不可：键名必须为单数 repo.packagist、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /；任一错误即静默回退官方源，验证需输出完整 JSON 对象。
composer install 在国内卡住，不是网络差，是默认还在直连 https://packagist.org。换镜像不是“提速技巧”，而是能正常执行的前提——配错或漏配，Composer 会静默 fallback，你根本看不到报错。
为什么 composer config -g repo.packagist 总是不生效
这条命令失败率极高，原因就三个硬伤，缺一即失效：
-
repo.packagist写成repos.packagist（多一个s）：Composer 2.x 完全忽略，不提示也不报错 - 漏掉中间的
composer：命令变成composer config -g repo.packagist https://mirrors.cloud.tencent.com/composer/，缺少 type 声明，直接回退官方源 - URL 末尾没加
/：比如写成https://mirrors.aliyun.com/composer，拼出/p2/xxx.json时变成双斜杠，部分版本返回 404，请求直接失败
验证是否真生效，只看这一条：composer config -g repo.packagist。输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.cloud.tencent.com/composer/"}。空、null、或只返回字符串，说明配置根本没写进去。
项目级配置怎么安全追加不覆盖私有源
全局配置在 CI、宝塔、Docker 等场景下极易失效（执行用户 ≠ 配置用户），推荐进项目根目录用不带 -g 的命令：
- 执行
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/ - 它会自动向
composer.json的"repositories"字段追加一条"packagist"条目，不覆盖已有 Git 私仓或 Satis 源 - 前提是原
"repositories"是对象{}；如果是数组[]，需先手动改为空对象再运行 - 千万别手写
"packagist.org": false——这会关掉兜底机制，镜像临时不可用时，composer install直接失败
改完必须删掉 vendor/ 和 composer.lock，再跑 composer install。旧 lock 文件里的哈希和镜像元数据不匹配，会导致校验失败或下载中断。
立即学习“PHP免费学习笔记（深入）”；
composer create-project 构建脚手架仍慢？关键参数不能少
即使镜像已生效，create-project 默认会 clone Git 仓库并保留 .git，这是新项目初始化阶段的最大瓶颈：
-
--no-interaction：跳过交互式提示（如数据库前缀、APP_KEY 生成），避免卡在 stdin 等待 -
--remove-vcs：直接删掉.git目录，省去初始化、fetch、checkout 时间 -
--prefer-dist：强制走压缩包而非 Git clone（虽默认启用，但显式声明更稳妥）
例如构建 Laravel 11：
composer create-project laravel/laravel myapp --no-interaction --remove-vcs --prefer-dist
漏掉其中任意一个，速度可能直接打五折。
换镜像后还卡在 Resolving dependencies？和镜像无关
镜像只加速下载（Downloading 阶段）和元数据拉取，不解决依赖解析卡顿。这个阶段卡住，基本可排除网络问题：
-
"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"这类宽泛约束会让 Composer 尝试大量组合 -
require-dev里塞了未锁定版本的工具链（如"phpunit/phpunit": "^9"） - 存在大量
dev-分支依赖，或composer.lock未提交/未固定
临时解法是删 vendor 和 lock 后重装，但治标不治本。真正要做的，是收紧版本约束、禁用不稳定分支、锁定开发依赖。
最常被忽略的一点：镜像配置成功 ≠ 全流程提速。从 create-project 到 install 再到 update，每个环节都有独立瓶颈，得逐段验证日志（比如加 -vvv 看 Downloading from 后面的域名是不是镜像地址），而不是只信 config 输出。
