中文镜像本身不提升 Composer 解析速度，但能显著降低 composer install 失败率——关键不在“快”，而在“不掉链子”；其核心作用是解决国内直连 packagist.org 导致的 TLS 握手失败、DNS 污染和 CDN 不可达等连接中断问题，将不可靠的网络请求转化为可重试的 HTTP 5xx 响应，而非单纯提速下载。
直接结论：中文镜像本身不提升 Composer 解析速度，但能显著降低 composer install 失败率——关键不在“快”，而在“不掉链子”。
为什么composer install卡在 Downloading 不是网速问题
现象是命令停在 Downloading https://packagist.org/packages.json 或某个 ZIP 地址，实际是配置未命中，而非下载慢。国内直连 packagist.org 常因 TLS 握手失败、DNS 污染或 CDN 节点不可达直接中断，而镜像站（如阿里云）用稳定 HTTPS + 全量 CDN 覆盖，把“连接失败”变成“可重试的 HTTP 5xx”。
-
composer config -g repo.packagist输出为空或"https://packagist.org"，说明根本没生效 - 执行
composer diagnose，若提示secure-http: OK但signature verification: disabled，说明镜像跳过了签名校验，有安全风险 - CI 构建中用
sudo composer config -g写入 root 配置，但 runner 用户读不到，等于白配
composer config -g repo.packagist 三个硬性条件缺一不可
这条命令不是“大概对就行”，漏掉任意一个都会静默回退到官方源，且不报错：
-
-g不能省：缺了就只改当前项目composer.json，换目录就失效 -
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） -
composer是 type 值，必须显式写出——省略后 Composer 2.0+ 会 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须用 HTTPS，且末尾斜杠/不能少（少斜杠会拼出/composerpackages.json导致 404）
正确写法：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
项目级配置比全局更可靠，尤其适合 CI 和团队协作
全局看着省事，但权限、用户、缓存三重干扰让它在真实生产场景里容易失效。项目级配置可提交进 Git，行为一致：
- 进项目根目录运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动往
composer.json的repositories字段安全追加，不覆盖已有私有源 - 如果
repositories是数组格式（"repositories": []），命令会报错；需先手动改成对象格式"repositories": {} - 别手写
"packagist.org": false——这会彻底关掉官方源，一旦镜像临时不可用，composer install直接失败
换源后仍装不出包？先查 composer.lock 是否被真正读取
现象：composer install --no-dev --optimize-autoloader 返回 0，但 vendor/ 不全、类找不到。这不是网络问题，而是 composer.lock 没起作用：
- Docker 构建中常因
.dockerignore忽略了composer.lock，导致COPY后只剩composer.json - 运行
composer update提示Your lock file does not contain a compatible set of packages，说明composer.lock和composer.json冲突 - 换镜像后务必删掉
vendor/和composer.lock，再重新生成——旧 lock 文件里的 hash 可能和镜像元数据不匹配
镜像解决的是下载稳定性，不是依赖解析逻辑。如果卡在 Resolving dependencies 几十秒，基本是 PHP 版本约束太宽或 require-dev 塞了太多工具链，换任何镜像都无效。
