Composer国内镜像非代理，而是全量同步元数据；配置必须用composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，URL末尾斜杠、HTTPS、键名及type值缺一不可。
镜像不是代理，是元数据全量同步
国内 Composer 镜像（如 https://mirrors.aliyun.com/composer/）不转发请求，也不实时回源。它每天定时拉取 packagist.org 的完整元数据快照：包括 packages.json、每个包的 composer.json、dist 和 source 的 URL 模板、所有历史版本哈希值。Composer 请求时直接访问镜像域名，全程不触达海外地址。
这意味着：composer install 中的 Loading composer repositories 阶段，实际请求的是镜像上的 https://mirrors.aliyun.com/composer/packages.json；后续每个包的元信息、zip 下载地址，也都来自镜像生成的 JSON 片段，而非动态拼接或代理转发。
常见误解：
- “镜像只是缓存下载链接” → 错，它重写了整个依赖图谱的解析入口
- “换镜像后仍要连 packagist.org” → 错，只要配置正确，全程不发任何请求到官方源
URL 少一个斜杠就 404 的真实原因
Composer 内部硬编码了路径拼接逻辑：[mirror-url]/packages.json、[mirror-url]/p/[vendor]/[package].json。如果配置的 URL 缺少末尾斜杠（例如写成 https://mirrors.aliyun.com/composer），就会拼出 https://mirrors.aliyun.com/composerpackages.json —— 显然不存在，直接返回 404。
这个行为在 Composer 2.0+ 中没有容错机制，也不会 fallback 或提示，只会卡在 Loading composer repositories 并不断重试。
必须满足的格式条件：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅ - 必须使用 HTTPS：
http://在 Composer 2.9+ 中会被拒绝 - 不能手动拼接路径，必须交由
composer config命令写入
为什么 composer config -g repo.packagist 总是不生效
这条命令看似简单，但漏掉任意一个要素，Composer 就会静默忽略，继续连 packagist.org：
-
repo.packagist是唯一合法键名 —— 写成repos.packagist（多 s）、packagist.org或repositories.packagist都无效 - 中间的
composer是type值，不是注释或可选参数，必须显式写出 - 必须加
-g，否则只改当前项目composer.json，换目录即失效
验证是否真写进去了，只看这一条命令输出：composer config -g repo.packagist。正确结果应为完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；返回空、null、Key not found 或只有一行 URL 字符串，说明失败，立刻重试。
换源后仍卡在 Resolving dependencies？和镜像无关
镜像只加速网络 IO：拉取 packages.json、下载 zip 包。它不参与本地依赖解析——那部分完全由 Composer 进程在本地执行，基于 composer.json 约束、已缓存的元数据、以及 composer.lock 中记录的版本锁定。
如果你发现 composer update 卡在 Resolving dependencies 超过 10 秒，问题一定出在：
-
composer.json中写了过于宽泛的版本约束（如"^1.0 || ^2.0"），导致解析器穷举组合 - 本地缓存未清，
composer.lock仍指向旧 dist 地址，Composer 试图复用但失败后才退回到解析阶段 - 项目启用了
--classmap-authoritative但 classmap 没覆盖全部类，触发异常回退逻辑
换源后必须执行三步硬性操作：composer clear-cache、删掉 vendor/、删掉 composer.lock，再跑 composer install —— update 没用，它照着旧 lock 文件里的地址去下载。
