根本原因是默认配置未对齐导致composer反复解析和冗余加载；应显式禁用packagist.org、规范私有源url末尾斜杠、设type为composer，并在私有包中配置archive.exclude以减重lock文件。
大型项目里 composer install 卡在 Resolving dependencies、composer.lock 膨胀到 10MB+、私有包加载慢还报错——根本不是网络或磁盘问题，而是默认行为和配置没对齐，导致 Composer 反复解析、瞎 fallback、加载冗余 autoload。
为什么 --optimize-autoloader 不只是“快一点”
它把所有 PSR-4 映射转成静态 classmap，跳过运行时目录遍历。但注意：classmap 是“写死”的，如果代码里有 class_exists("{$prefix}".$name) 这类动态拼接类名的逻辑，会直接找不到类。
- 生产环境必须加：
composer install --optimize-autoloader或在composer.json中设"optimize-autoloader": true - 开发环境慎用：新增类不会自动进 map，得手动
composer dump-autoload -o - 若项目含大量动态类加载，改用
--classmap-authoritative（更激进）或保留 PSR-4 + 启用"apcu-autoloader": true（需 APCu 扩展）
私有仓库配置不生效？检查这三处硬性规则
私有包声明再正确，只要这三点漏一个，Composer 就当它不存在，转头去 packagist.org 死磕。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"packagist.org": false必须显式写在composer.json根级repositories外，不是放在某个仓库配置里 - 私有源 URL 末尾必须带
/：https://artifactory.example.com/repo/✅，https://artifactory.example.com/repo❌（内部视为不同源） - 后端仓库类型必须是
type: "composer"；Satis、Artifactory 的 Generic 类型仓库不提供packages.json接口，无法被识别
composer.lock 超过 8MB 就该动手减重了
它不只是锁版本，还存了每个包的 dist checksum、source commit、require-dev 列表……这些字段在大型项目里极易重复膨胀。
- 定期跑：
composer update --lock（不带包名），能合并冗余字段、压缩 JSON 结构 - 所有私有包的
composer.json里加"archive": {"exclude": ["/tests", "/docs", "/examples"]}，否则 Satis 构建时会给这些路径算 hash 并写进 lock - 删掉长期不用的
require-dev包，比如旧版phpstan/phpstan或废弃的测试辅助工具——它们不安装，但仍在 lock 里占解析开销
CI/CD 中认证失败别急着换密钥
报 Failed to clone https://gitlab.com/org/private.git 或 Authentication failed，大概率不是 token 或 SSH 密钥错了，而是 Composer 根本没读到认证凭据。
- SSH 方式下：
auth.json完全无效；Composer 只认系统 SSH agent 或~/.ssh/config里的Host别名配置 - HTTPS + PAT 方式下：token 权限必须包含
read_package_registry（GitLab）或packages:read（GitHub），且不能过期 - 私有 Git 仓库要走
vcs类型，不是composer类型；auth.json只对composer类型源生效
最常被忽略的是：私有包的 archive.exclude 和根级 "packagist.org": false，这两项不写，其他优化全白搭——Composer 会在后台默默 fallback、重复解析、加载无用路径，你只看到“卡”，却看不到它在干什么。
