换中文镜像是 composer install 能跑通的基本前提，而非可选提速；卡在 resolving dependencies 与镜像无关，主因是 php 版本约束过宽、dev 分支滥用或 lock 文件残留；全局配置需严格满足 repo.packagist（单数）、composer type 值、url 末尾带/三要素，否则静默失效；项目级配置更可靠，且须配合 --no-dev --prefer-dist 等参数及 clear-cache 才真正提速。
换中文镜像不是“提速可选操作”，而是让 composer install 能跑通的基本前提——没配镜像，90% 的国内项目会卡在 Downloading 或直接报 Connection timed out、SSL certificate problem。
为什么 composer install 一直卡在 “Resolving dependencies”？
镜像源只管下载，不管解析。这个阶段卡住，和镜像无关，但容易误判为“换源没用”：
-
composer.json里写了太宽的 PHP 版本约束（比如"php": "^7.4 || ^8.0 || ^8.1 || ^8.2"），求解器要穷举组合 - 设了
"minimum-stability": "dev"，强制拉取 dev 分支，候选版本数爆炸 -
composer.lock被删或没提交，install实际退化成update，重新解析全图 - 项目
composer.json的repositories字段指向了已下线私有源，Composer 逐个超时才 fallback
验证方法：进项目根目录，跑 composer config --list | grep repositories，看实际生效的是哪个源；再执行 composer validate --strict 检查 lock 文件是否合法。
composer config -g repo.packagist 总是不生效？
不是命令没运行，是三个硬性条件一错就静默失败（不报错、不提示、但完全不走镜像）：
-
repo.packagist不能写成repos.packagist（多一个s就彻底失效） - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致请求路径拼成/p2//类路径，直接 404） - 中间那个
composer是 type 值，不能漏：composer config -g repo.packagist composer https://...——漏掉就 fallback 到官方源
验证是否成功：运行 composer config -g repo.packagist，输出必须是完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
全局配置 vs 项目级配置，哪个更靠谱？
团队协作或 CI 环境中，项目级配置才是默认选择：
- 全局配置（
composer config -g）改的是~/.config/composer/config.json，所有项目共享——但宝塔、Docker 或 CI 流水线常以非 root 用户（如www）运行，它读不到 root 配的全局配置 - 项目级配置（去掉
-g）会往当前项目composer.json的repositories字段追加，且优先级高于全局，还能被 Git 提交，新人拉代码后行为一致 - 如果项目已有
repositories，别手动编辑 JSON（逗号错位直接导致JSON decode error），用命令追加更安全：composer config repo.packagist composer https://mirrors.aliyun.com/composer/
特别注意：项目级配置必须显式加 "packagist.org": false，否则 Composer 仍可能回退到官方源触发超时。
composer install 加哪些参数才算真正提速？
光换镜像只是第一步，生产环境必加这四个：
-
--no-dev：跳过require-dev（如phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销 -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：仅限部署用，告诉自动加载器“没在映射里 = 真没有”，彻底跳过文件扫描
CI/CD 中推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类会直接 Class not found。
最易被忽略的点：换镜像后一定要先 composer clear-cache，否则旧缓存可能掩盖切换效果；其次，composer.lock 里记录的是原始源地址，如果长期没更新，即使换了镜像，install 仍可能按 lock 文件里的旧路径去 fetch —— 这时候得删 lock 和 vendor 重装。
