Composer 中文镜像仅加速元数据拉取和包下载，不加速依赖分析（Resolving dependencies），因其在本地执行 SAT 求解且无网络请求；常见卡顿源于 memory_limit 过低、xdebug 启用或版本约束过宽，需清理 vendor/ 和 composer.lock 并正确配置镜像。
Composer 中文镜像本身不加速依赖分析（Resolving dependencies）过程，只加速元数据拉取和包下载；所谓“解析提速”是常见误解。
为什么 composer update 卡在 Resolving dependencies 不是镜像能解决的
这个阶段 Composer 在本地做 SAT 求解（版本约束满足性判断），完全不发网络请求。镜像再快也帮不上忙——它只影响 Loading composer repositories 和 Downloading 这两个环节。
- 典型表现：
composer update -vvv日志停在Resolving dependencies超过 10 秒，且后续无 HTTP 请求输出 - 真实瓶颈常是：
php.ini中memory_limit过低（默认 128M 不够）、启用了xdebug、composer.json里写了过于宽泛的版本约束（如"*"或"^1.0 || ^2.0"） - 验证方式：临时设
COMPOSER_MEMORY_LIMIT=-1再跑，若明显变快，说明就是内存不足
composer config -g repo.packagist 必须写对三处才真正生效
90% 的“配了还是慢”问题，源于这条命令静默失败——不报错，但根本没写进配置。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist（单数，repos.packagist多一个 s 就无效） - 中间必须显式传
composer作为 type 值：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌ - 验证是否成功：
composer config -g repo.packagist输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}或至少是完整 URL 字符串
换镜像后仍卡在 Downloading？大概率是 composer.lock 没清干净
镜像只改元数据源（packages.json 等），但 composer.lock 里记录的 dist.url 仍是原始 GitHub 地址。不清理就等于白配。
- 必须删掉
vendor/和composer.lock两个文件/目录 - 再执行
composer install，让 Composer 重新走镜像拉元数据，并生成指向镜像站的新dist.url - 如果项目依赖私有包（GitHub 直链、GitLab、Satis），镜像对其无效，需单独配置
repositories或用path类型本地源 - 宝塔、Docker、CI 环境要注意用户权限：全局配置写在
/root/.composer/config.json，但 www 用户或非 root 容器进程读不到，得用sudo -u www composer config -g ...
项目级配置比全局更可靠，但别用命令覆盖 repositories
团队协作或 CI 流水线中，全局配置容易因用户、缓存、初始化顺序导致行为不一致；项目级写进 composer.json 才可预期。
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g） - 该命令会自动向
composer.json的repositories数组追加条目，不会清空已有私有源 - 已有
"repositories": { "my-private": { "type": "vcs", ... } }？别用命令，手动编辑 JSON，在repositories数组里加一条{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}，并确保顶层有"packagist.org": false - 改完务必运行
composer update --lock，否则新镜像地址不会写入composer.lock
真正卡住的地方往往不在网络，而在本地 PHP 配置、锁文件残留、或权限错位——镜像只是第一层，后面这几步漏掉任何一环，都白忙活。
