composer镜像配置90%失效源于命令错误：键名必须为单数repo.packagist、type值必须显式写composer、url须https且末尾带/，三者缺一即静默回退官方源。

镜像配置没生效，90% 是命令写错了，不是网络或镜像本身的问题。

composer config -g repo.packagist 命令为什么总不生效

这条命令看似简单，但 Composer 2.9.6+ 对格式极其敏感，错一个字符就静默 fallback 到 https://packagist.org，且完全不报错。

• repo.packagist 必须是单数：写成 repos.packagist、repositories.packagist.org 或 packagist 都无效
• 中间的 composer 是 type 值，不是可选参数：漏掉它（如 composer config -g repo.packagist https://...）会导致整条配置被忽略
• url 必须以 / 结尾：用 https://mirrors.aliyun.com/composer（缺斜杠）会拼出 /composerpackages.json，直接 404
• 必须用 https:// 开头：HTTP 地址会被拒绝或触发 301 跳转，而某些环境（Alpine、企业代理）不自动跟随

验证是否真写进去了：composer config -g repo.packagist 输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、只返回 URL 字符串，都说明失败。

项目级 repositories 字段覆盖全局配置

只要项目根目录的 composer.json 里有 repositories 字段，全局镜像就彻底失效——不是优先级低，是直接跳过。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 检查方法：composer config repo.packagist（不带 -g），有输出即表示项目级配置正在生效
• 常见陷阱："repositories": {} 这种空对象也会禁用默认源；"packagist": false 会导致基础扩展（如 ext-json）校验失败
• 安全写法：进项目目录执行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g），它会自动合并进 repositories 对象，key 固定为 "packagist"
• 如果 repositories 是数组格式（[]），该命令会报错；需先手动改成对象（{}）再重试

换镜像后仍报 hash 不匹配或 Failed to extract

这不是网络问题，是旧缓存和 lock 文件残留导致的路径与校验冲突。

• composer.lock 里记录的是官方源的 dist URL 和哈希值，切换镜像后 Composer 仍按原路径去阿里云找 ZIP 包，但镜像服务内部路径映射不同，必然校验失败
• 必须删掉整个 vendor/ 目录和 composer.lock 文件，再运行 composer install（不是 update）
• composer clear-cache 必须同步执行：旧缓存里存着 https://packagist.org 的元数据，不清掉，后续请求仍可能触发 404 或签名失败
• 手动删缓存目录更彻底：rm -rf ~/.composer/cache/repo/https---packagist.org/（Linux/macOS）或 %APPDATA%\Composer\Cache\repo\https---packagist.org\（Windows）

如何确认流量真的走镜像，而不是“我以为它在用”

别信 composer config 的输出，它只反映配置内容，不反映实际行为。真实证据只有网络请求日志。

• 运行 composer diagnose，看 Repo packagist.org: 这一行后面的域名是不是你配的镜像地址
• 执行 composer require monolog/monolog --no-install -vvv，第一行日志里的 Downloading https:// 后面的域名才是真实请求源
• 加 -vvv 后执行 composer install，用 grep -i "mirrors.aliyun" 检查输出，没匹配到就说明还在直连海外
• 终极验证：用 curl -I -L https://mirrors.aliyun.com/composer/packages.json 直击 HTTP 层，看是否返回 200 OK；若反复 302 Found 循环，说明镜像服务或 CDN 配置异常

最容易被忽略的一点：宝塔、CI 流水线、Docker 容器等环境，执行用户和你本地终端用户往往不同，composer config -g 写的配置根本没被读到。先 whoami，再给对应用户单独配，比反复改命令更省时间。