composer国内需配中文镜像，正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，三要素缺一不可，且须验证生效、注意用户权限与项目级覆盖问题。
不配中文镜像，Composer 在国内基本没法用——不是慢，是根本装不完。卡在 Downloading、Connection timed out、403 Forbidden，根源几乎全是直连 packagist.org 导致的限速和拦截。
composer config -g repo.packagist 命令写错就等于没配
这条命令必须严格满足三要素，漏一不可，且错一个也不报错，而是静默回退到官方源：
-
repo.packagist是唯一合法键名（注意是 单数repo，不是repos.packagist或packagist.org） - 中间的
composer是type值，不是注释，不能省略或替换成其他字符串 - URL 必须是 HTTPS，且末尾必须带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json直接 404 ❌ - 必须加
-g，否则只改当前项目目录下的composer.json，换个项目就失效
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否真生效，别靠感觉
执行完命令，立刻验证，而不是等下次 install 看快不快：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist，输出必须是完整 JSON，形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空、
null、报错Key "repo.packagist" does not exist，说明命令根本没写进去 - 再跑
composer diagnose，看Repo packagist.org:后面是不是你设的镜像地址 - 最后加
-vvv跑一次composer install，日志里出现的域名要是mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn，不是packagist.org
全局配置在宝塔/CI 里经常不生效
全局配置写在 /root/.composer/config.json，但宝塔「一键部署」、PHP 管理器、GitLab Runner 默认以 www 或 runner 用户运行，根本读不到 root 的配置：
- 先确认实际执行用户：
ps aux | grep composer或查宝塔日志里的 UID - 切换到对应用户再配一次：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本里建议统一用项目级配置，避免权限问题：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动写入composer.json的repositories字段
镜像只加速下载，卡在 Resolving dependencies 是另一回事
换镜像后仍卡在 Resolving dependencies，说明问题不在网络，而在本地解析环节：
- 检查 PHP 内存限制：
COMPOSER_MEMORY_LIMIT=-1 composer update临时绕过内存不足导致的反复重试 - 确认没启用 xdebug：
php -v看输出里有没有xdebug，有就加php -d xdebug.mode=off $(which composer) install - 删掉
vendor/和composer.lock，再跑composer install --no-cache，排除 lock 文件残留已下线包的问题 - 项目
composer.json里写了太宽的 PHP 版本约束（如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"）会让求解器爆炸式遍历组合，收紧约束能立竿见影
真正容易被忽略的是：镜像配置只是提速的第一步，后续还要配合 --no-dev、--prefer-dist、--optimize-autoloader 这些参数才能发挥全部效果；而一旦项目里已有 repositories 字段，全局配置就会被静默覆盖——这点连很多老手都会踩坑。
