Composer中文镜像不生效的主因是配置静默失败：repo.packagist键名拼错（如多s）、漏写type值composer、URL缺末尾斜杠、未加-g参数，任一错误均导致回退官方源；必须清缓存、防项目级repositories覆盖，并验证config输出为完整JSON。
composer 中文镜像不是“装了就快”，而是必须配对生效、清缓存、防覆盖，否则 95% 的慢都白调。
为什么 composer config -g repo.packagist 总是不生效
它根本没写进去，但也不报错——这是最坑的静默失败。
-
repo.packagist写成repos.packagist（多一个 s）：Composer 完全忽略，查composer config -g repo.packagist输出为空或null - 漏掉中间的
composer类型值：命令写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/，缺composer，结果 fallback 到官方源 - URL 少了末尾
/：变成https://mirrors.aliyun.com/composer，请求会拼出/packages.json→/composerpackages.json，直接 404 - 没加
-g：只改当前目录下的composer.json，换项目、进子目录就失效
验证是否真写进去了：composer config -g repo.packagist 必须输出完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。其他任何输出都代表失败。
composer install 还卡在 “Resolving dependencies”？镜像压根不参与
镜像只管下载，不管解析。这个阶段卡住，和网络、镜像完全无关。
-
"php": "^7.4 || ^8.0 || ^8.1"这类宽泛约束会让依赖求解器暴力穷举组合，耗时指数级增长 -
"minimum-stability": "dev"强制拉取不稳定分支，候选版本数暴涨 - 项目删了
composer.lock或没提交，install实际退化为update，触发全量解析 -
repositories里写了已下线的私有源，Composer 逐个超时才 fallback，日志里看不到镜像请求
快速定位：运行 composer config --list | grep repositories 看实际加载了哪些源；再跑 composer validate --strict 检查 lock 文件合法性。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
Docker 和 CI 中，-g 配置基本等于没配
全局配置写在 /root/.composer/config.json，但容器里跑的是 www 用户，CI 流水线用的是 runner 用户，它们读不到 root 的配置。
- 在 Dockerfile 里必须显式固化：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意路径和用户权限） - CI 中推荐项目级配置：进项目根目录执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会自动写入composer.json的repositories字段，Git 可追踪、跨环境一致 - 别手动编辑
composer.json的repositories，容易格式错误；用命令追加更安全，尤其当已有私有源时 - 改完必须删掉
vendor/和composer.lock，再composer install—— 旧 lock 记录的是 packagist.org 的哈希，和镜像元数据不兼容
--prefer-dist 被悄悄禁用？检查 composer.json 里的 prefer-source
这个参数是提速关键，但它会被项目级配置强行覆盖，而且不提示。
- 搜索项目根目录的
composer.json是否含"prefer-source": true字段（常因协作误提交） - 修复方式：执行
composer config --unset prefer-source，或手动删掉该字段 - 私有包若只提供 Git 地址、没发布 dist 包，
--prefer-dist会直接报Could not find a matching version，此时只能关掉该参数，或补 dist 发布流程 - 国内镜像（如阿里云）只缓存 dist 包，不缓存 source；一旦镜像失效，
--prefer-dist会降级为慢速git clone，反而更卡
真正起效的组合从来不是单点优化：镜像源 + 清缓存 + 项目级写入 + --prefer-dist --no-dev --optimize-autoloader，缺一不可。最容易被跳过的，是删旧 vendor 和 lock —— 换源后还抱着旧文件跑，等于在高速路上开拖拉机。
