直接换阿里云镜像并加--no-interaction --prefer-dist --optimize-autoloader可解决90%部署卡顿；composer config -g repo.packagist命令必须同时满足四点：带-g参数、键名repo.packagist（单数）、中间含composer类型值、url以/结尾，否则静默失效；验证需输出完整json；ci/cd推荐项目级配置并清缓存。
直接换阿里云镜像并加 --no-interaction --prefer-dist --optimize-autoloader，90% 的部署卡顿当场消失。不是网络差，是默认还在连 packagist.org。
composer config -g repo.packagist 命令必须写对这四点
这条命令极易静默失效，不报错也不起作用，必须同时满足：
-
-g参数不能漏，否则只改当前项目，CI/CD 环境读不到 - 字段名是
repo.packagist（单数），写成repos.packagist（多一个 s）就完全忽略 - 中间必须带
composer类型声明：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - URL 必须以斜杠结尾：
https://mirrors.aliyun.com/composer/，少斜杠会拼出/composerpackages.json导致 404，但日志只卡在 “Loading repositories”
验证是否生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或仍为 https://packagist.org 都说明没写进去。
CI/CD 里 install 还卡？别信全局配置，用项目级 repositories
GitHub Actions、GitLab CI 或 Docker 构建时，composer config -g 写的是 root 或你本地用户的 ~/.composer/config.json，而 runner 通常以 www-data 或普通用户运行，根本读不到。
稳解是把镜像写进项目本身：
- 在项目根目录执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不带-g） - 该命令会安全写入
composer.json的"repositories"字段，key 必须是"packagist"，不能改成"aliyun"等别名 - 已有
"repositories"字段时自动合并，避免手动编辑 JSON 出现逗号或引号错误 - 提交
composer.json后，所有协作者和 CI 作业行为一致
换源后还是慢？先清缓存，再看卡在哪一阶段
Composer 不会自动丢弃旧缓存。哪怕镜像已换，它仍可能从 packagist.org 的旧元数据里解析依赖，导致卡在 Loading composer repositories with package information 超过 30 秒。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
唯一有效的清缓存命令是：composer clear-cache。别跳过，也别指望 composer update -v 自动刷新。
区分卡点：
- 卡在
Loading composer repositories或Downloading→ 镜像没生效，回退查composer config -g repo.packagist或加-vvv看实际请求域名 - 卡在
Resolving dependencies→ 和镜像完全无关，是本地求解器穷举版本组合，常见于"php": "^7.4 || ^8.0 || ^8.1"这类宽泛约束，或启用了 Xdebug（会让该阶段慢 5–10 倍）
部署脚本里必须加的三个参数
CI/CD 或生产环境部署，composer install 必须带：
-
--no-interaction：CI 环境无终端交互，不加会卡住等待输入 -
--prefer-dist：强制走 ZIP 包而非 git clone，避免因 Git 缺失、SSH key 不可用或子模块同步中断 -
--optimize-autoloader：生成 classmap，提升运行时性能，且不影响部署速度
完整命令示例：composer install --no-interaction --prefer-dist --optimize-autoloader --no-dev。别写 composer update 上生产——它会重新解析依赖树，触发大量网络请求，应只在开发环境运行。
最常被忽略的是缓存路径和 composer.lock 的一致性：Docker 或 GitHub Actions 中，仅缓存 ~/.composer/cache 不够，vendor/ 和 composer.lock 必须严格匹配 PHP 版本与 platform 配置，否则缓存无效。
