必须配置国内镜像，因packagist.org在国内基本不可达；验证需运行composer config -g repo.packagist，输出必须是{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，空、null或含packagist.org均说明未生效。
遇到 composer install 报错，80% 以上不是代码或依赖本身的问题，而是卡在元数据加载阶段——直连 https://packagist.org 在国内基本不可用。优先配国内镜像，不是“试试看”，而是必须做的第一步。
怎么确认是不是镜像没生效
别猜，直接查：
运行 composer config -g repo.packagist。
如果输出是空、null、或者还是 {"type": "composer", "url": "https://packagist.org"}，说明你根本没切过去，正在裸连欧洲服务器。
- 输出必须是完整 JSON，形如
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回字符串（比如只有一行 URL），说明配置写错了字段或漏了
type - 项目目录下执行
composer config repo.packagist（不加-g）可查项目级配置，它会覆盖全局设置
配阿里云镜像的命令必须严格按这三条写
以下命令任一字符出错都会静默失败，表面成功，实际仍走官方源：
- 键名必须是
repo.packagist（不是repos.packagist，多一个s就被忽略） - 第二个参数必须是
composer（这是type值，不能省略，也不能写成composer-type或其他） - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌
正确命令：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
配完还是卡在 Downloading？用 -vvv 看真实请求地址
光看命令执行完没报错没用。真正卡住时，得确认请求发到了哪：
- 运行
composer require monolog/monolog -vvv - 盯紧第一行
Downloading后面的 URL：如果是packagist.org，说明镜像完全没命中 - 常见干扰项：
composer.json里已有"repositories"字段，它会优先于全局配置；删掉或改掉它再试 - CI/CD 或宝塔环境常以
www用户运行，你的root全局配置它读不到，得用sudo -u www composer config -g ...
换源后依然报错，先排除非网络问题
镜像只加速下载，不解决本地环境问题。如果换源后仍失败，重点排查这几件事：
-
vendor/autoload.php不存在？可能是composer install被 Ctrl+C 中断，直接删掉vendor/和composer.lock，重跑composer install -
php -m | grep -E "openssl|mbstring"检查扩展是否启用，缺openssl会导致静默失败 - Windows 路径含空格或中文（如
C:\Program Files\php）会让proc_open()失败，换纯英文短路径 - 某些企业内网禁 HTTPS，可临时用 HTTP 镜像：
http://mirrors.cloud.tencent.com/composer/，但仅限调试
最常被忽略的是：配镜像只是第一步，后续所有操作都依赖它是否真被读取——验证必须落到 composer config -g repo.packagist 的输出和 -vvv 日志里的域名上，而不是“我明明执行了命令”。
