根本原因是ci中未正确配置双路径缓存（vendor/和~/.composer/cache）且缺失--no-interaction、--prefer-dist、--optimize-autoloader三个必选参数；即使镜像配置正确，缺一不可导致缓存失效、退化为source下载或卡在交互环节。
为什么换镜像后CI里composer install还是慢
根本不是镜像没生效，而是缓存路径没配对、参数没带全。即使composer config -g repo.packagist输出国内地址（比如https://mirrors.aliyun.com/composer/），只要~/.composer/cache没缓存，每次仍要重下 ZIP 包；只要没加--prefer-dist，Composer 就默认走 source（git clone），在 CI 里极易因 SSH 配置缺失或网络超时失败。
- 先验证镜像是否真生效：
composer config -g repo.packagist必须输出镜像 URL，为空或仍是packagist.org说明配置没落进 CI 环境 - 换镜像后务必执行
composer clear-cache——旧缓存里可能还存着 packagist.org 的元数据，不清理会继续走境外源 - GitLab CI / GitHub Actions 中，
composer config -g命令需放在 job 开头执行，不能只在本地跑过就以为全局生效
CI 中必须同时缓存的两个路径
只缓存vendor/等于白干。真正决定下载快慢的是~/.composer/cache：它存着所有 dist ZIP 包、校验哈希、metadata 缓存。没它，--prefer-dist就退化成--prefer-source，每包都得重新拉 Git 仓库。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须声明双路径缓存：
vendor/（注意排除vendor/bin/符号链接和生成文件如autoload.php） +~/.composer/cache - 推荐显式设
COMPOSER_CACHE_DIR为$HOME/.composer-cache-$PHP_VERSION，避免多 PHP 版本混用导致缓存污染 - GitLab CI 示例中
key: "$CI_JOB_NAME-php-${PHP_VERSION}"要带$PHP_VERSION变量，否则 php:8.2 和 php:8.3 共享同一缓存，解包失败静默发生
composer install 必须带的三个参数
缺任何一个，缓存复用率就断崖下跌。这不是“可选优化”，是 CI 场景下的硬性要求。
-
--no-interaction：避免交互式提示卡住流水线（比如 license 确认） -
--prefer-dist：强制走 ZIP 包而非 git clone；私有包若必须走 source，应在composer.json里用"preferred-install"局部覆盖 -
--optimize-autoloader：生成vendor/composer/autoload_static.php，跳过运行时 PSR-4 动态解析，加载快且稳定
vendor 目录能直接缓存吗？风险在哪
能，但极不推荐。直接缓存vendor/绕过了 Composer 的完整性校验流程——它不校验 ZIP 哈希、不重建autoload_static.php、不检查 PHP 扩展兼容性。一旦 PHP minor 版本升级（如 8.2.12 → 8.2.15），opcache 行为微变，缓存的vendor/可能让测试通过，线上却报Class not found。
- 更安全的做法：只缓存
~/.composer/cache，每次composer install都从 cache 重建vendor/——既保留速度，又守住一致性 - 如果真要缓存
vendor/，必须严格锁定：PHP_VERSION、Composer 版本、OS 发行版、扩展列表四者完全一致，少一个都不行 - CI 脚本末尾加一句
ls -la vendor/autoload.php && composer dump-autoload -o，能快速确认 vendor 是否真实可用，而不是缓存了个空目录
~/.composer/cache或少一个--prefer-dist，再快的镜像也救不回那两分钟下载时间。
