Composer卡在“Resolving dependencies through SAT”是SAT求解器暴力穷举版本组合导致的卡死，非网络问题；应立即Ctrl+C中断，运行composer update --dry-run -v定位冲突包、composer why-not直击阻断链，并删require-dev重型工具后重试--no-dev。
composer install卡在“Resolving dependencies through SAT”就是求解器崩了
这不是慢，是 Composer 的 SAT 求解器正在暴力穷举所有版本组合——尤其当 composer.lock 里混着 300+ 包、几十个私有源、以及 "monolog/monolog": "^1.0 || ^2.0" 这类宽松约束时，回溯深度可能突破 10⁴ 级。CPU 占满、内存缓涨、终端静默超过 90 秒，基本可以判定已卡死。
别等它自己出来，Ctrl+C 中断后立刻做三件事：
- 运行
composer update --dry-run -v，看最后几行明确报出哪两个包“cannot be installed together” - 用
composer why-not package/name:version直击阻断链（比如composer why-not symfony/console:6.4） - 临时删掉
require-dev里的phpunit/phpunit、phpstan/phpstan等重型工具，再试composer update --no-dev
lock-file-version: 2 不是可选项，是性能底线
旧版 composer.lock（v1）会为每个包冗余存下完整 require-dev 列表、source commit、dist checksum 等元数据，百万级依赖下文件常超 15MB；v2 压缩了字段结构、去掉了重复键、改用更紧凑的 JSON 序列化方式，实测解析耗时下降 35–50%。
确认并强制升级的方法：
- 检查
composer.json是否含"lock-file-version": 2（必须是数字，不是字符串） - 若没生效，直接删掉现有
composer.lock，再执行composer install（确保composer.json无变更） - 或运行
composer update --lock，不改依赖，仅重写 lock 文件
--no-dev 和 --prefer-dist 必须一起用，否则等于没关
--no-dev 只跳过安装 dev 包，但默认仍要解析它们的约束；--prefer-dist 强制走 ZIP 包而非 Git clone，但若镜像配置失效或缓存未清，它会 fallback 到 source 模式，反而更慢。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真实生效的前提条件：
- 先执行
composer clear-cache，否则旧缓存仍打原站 - 确认镜像已全局生效：
composer config -g repo.packagist输出应为扁平 URL，不能是{"packagist.org": {...}} - CI/CD 中必须加
--no-interaction --no-progress：前者防挂起，后者避免 ANSI 控制符刷屏拖慢日志写入
autoload 扫描路径太宽会拖垮整个解析流程
很多人以为 autoload 只影响运行时，其实 Composer 在生成 autoload_classmap.php 前，会递归扫描所有声明的目录——如果 vendor/ 里混入了测试用例、文档示例、Mock 类，或项目自身 autoload 配置写了 "psr-4": {"App\": "app/"} 却没排除 app/Tests，I/O 开销会指数上升。
快速自查与收敛方式：
- 运行
ls -lh vendor/ | head -20，看是否有异常大的包（如含完整 docs 或 tests 目录） - 在对应包的
composer.json中确认是否设了"archive": {"exclude": ["/tests", "/docs"]} - 项目级
autoload改用精确路径，例如把"App\": "app/"拆成"App\": "app/Http/Controllers/", "App\Models\": "app/Models/"
真正难处理的是那些早已废弃但仍在 composer.lock 里占位的 dev 工具——它们不安装，却参与每一轮解析。删掉它们比优化 autoload 更立竿见影。
