CI中composer install卡住八成因未切国内镜像源；应全局配置阿里云镜像、动态注入auth.json凭据、缓存~/.composer/cache而非vendor/，并强制使用--no-dev --optimize-autoloader --classmap-authoritative --no-interaction组合参数。
CI里composer install卡住，八成是镜像源没切国内
CI构建中composer install长时间无响应、超时或报Connection refused，不是网络抽风，而是还在连默认的国外Packagist。GitHub Actions、GitLab CI这些共享runner出口IP常被限速，一试就卡在Downloading https://packagist.org/packages.json。
实操建议：
- 全局配置（推荐）：CI脚本开头加
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级覆盖（更安全）：在
composer.json里加"repositories"字段，优先级高于全局，避免污染其他项目 - 别用
composer config --global配多个镜像——Composer只认第一个，后配的无效 - 验证是否生效：跑
composer config -g repo.packagist，输出应为阿里云或腾讯云地址，不是https://packagist.org
私有包拉不到？auth.json不能硬编码，得走环境变量注入
CI里composer install报Could not fetch https://gitlab.example.com/api/v4/projects/123/repository/archive.zip，本质是没凭据。直接把auth.json提交到仓库等于公开公司Token，绝对禁止。
正确做法分两步：
- 在CI平台（如GitHub Secrets、GitLab CI Variables）预设变量，比如
GITLAB_TOKEN或GITHUB_TOKEN - CI脚本中动态生成
auth.json：echo '{"http-basic": {"gitlab.example.com": {"username": "token", "password": "'"$GITLAB_TOKEN"'"} } }' > ~/.composer/auth.json - 注意路径必须是
~/.composer/auth.json，Composer不读项目根目录下的同名文件 - 敏感值别用
echo拼接——如果Token含特殊字符（如$、'），改用printf %s "$GITLAB_TOKEN" | base64 -d等安全方式
缓存vendor目录？这是CI里最危险的优化
有人为了提速，在CI里缓存vendor/并跳过composer install，结果上线后随机报Class not found或Cannot declare class。这不是Bug，是缓存错环境的必然结果。
根本原因：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
vendor/里的autoload_classmap.php和autoload_static.php依赖PHP版本、扩展开关（如ext-opcache）、甚至文件系统大小写策略 - 本地开发机是macOS（大小写不敏感），CI runner是Ubuntu（敏感），缓存混用直接导致类加载失败
- 真正该缓存的是
~/.composer/cache——它只存zip包和dist归档，跟环境完全解耦 - GitHub Actions示例中
key必须含${{ hashFiles('**/composer.lock') }}，lock文件一变，缓存自动失效，杜绝“旧包新用”
--optimize-autoloader和--classmap-authoritative必须一起用
只加--optimize-autoloader不加--classmap-authoritative，autoload性能几乎没提升。PHP仍会 fallback 到file_exists()探测每个PSR-4路径，IO开销照旧，尤其在容器化部署中，磁盘IO本就是瓶颈。
生产部署命令必须是：
composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction
漏掉任一参数的后果：
- 缺
--no-dev：dev依赖（如phpunit）进vendor，class_exists('PHPUnit\Framework\TestCase')可能触发fatal error - 缺
--classmap-authoritative：autoloader不信任classmap，仍遍历整个src/目录找类，opcache也救不了 - 缺
--no-interaction：某些插件（如hirak/prestissimo旧版）会卡在交互式确认，CI直接挂起
这三者不是可选项，是生产环境autoload的最小可行配置。CI里跑一次composer dump-autoload --optimize没用，它不生成classmap，只做PSR映射扁平化。
