Composer 2.x 默认启用 classmap-authoritative 模式，跳过 PSR-4 动态扫描，仅依赖 autoload_classmap.php；开发中新增类未被 dump-autoload 覆盖即报 Class not found，需显式关闭该模式或确保 classmap 完整覆盖。
Composer 2.x 升级后 autoload 行为变化导致类找不到
Composer 2.x 默认启用 classmap-authoritative 模式（即 "optimize-autoloader": true 时自动生效），这会跳过 PSR-4/PSR-0 的动态路径扫描，只依赖生成的 vendor/composer/autoload_classmap.php。如果你在开发中动态新增了未被 composer dump-autoload 覆盖的类文件，运行时就会报 Class not found。
解决方法：
- 开发阶段显式关闭权威模式：
composer install --no-autoloader --optimize-autoloader=false，或在composer.json中设"optimize-autoloader": false - 确保新增类文件后执行
composer dump-autoload -o（注意：2.x 的-o默认含--classmap-authoritative） - 若用 symlink 安装本地包（
pathrepo），需确认其autoload配置已被主项目dump-autoload扫描到——2.x 不再隐式 fallback 到包内autoload.php
PHP 8.1+ 环境下 composer install 报 Array and string offset access syntax with curly braces is deprecated
这不是你代码的问题，是 Composer 1.x 自身不兼容 PHP 8.1+。Composer 1.x 在解析 composer.lock 或处理版本约束时仍使用已废弃的 $str{0} 语法。只要 PHP 版本 ≥ 8.1，哪怕项目本身无该语法，也会在 Composer 运行时触发 E_DEPRECATED。
必须升级到 Composer 2.2.0+（推荐 2.5.0+），因为：
- 2.2.0 起完全移除大括号字符串访问，适配 PHP 8.1+
- 2.3.0+ 开始默认禁用
allow-plugins安全机制，插件需显式授权，否则install会中断 - 升级命令统一用：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && php composer-setup.php --filename=composer --install-dir=/usr/local/bin && php -r "unlink('composer-setup.php');"
composer update 在 2.x 中变慢且卡在 Resolving dependencies
Composer 2.x 默认启用更严格的依赖解析策略（如 full SAT solver），尤其在 lock 文件陈旧、约束宽泛（如 ^1.0 || ^2.0）、或存在大量 private repos 时，耗时可能翻倍甚至超时。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
提速关键点：
- 先清理缓存：
composer clear-cache（2.x 缓存结构变更，旧缓存可能拖慢解析） - 缩小更新范围：
composer update vendor/package-name，避免全量重解析 - 临时禁用插件（尤其自定义 installer）：
composer update --no-plugins - 检查
composer.json中是否误用了通配符约束（如"*"或"dev-main"），它们会强制走最慢的解析路径
allow-plugins 配置引发的 CI 失败和本地执行差异
Composer 2.2+ 默认阻止所有插件自动加载，除非在 composer.json 根级声明 "allow-plugins" 白名单，或全局配置 composer config -g allow-plugins true。CI 环境通常用干净容器，没做该配置，就会在 install 阶段直接报错并退出。
安全与兼容建议：
- 在项目
composer.json中明确列出所需插件："allow-plugins": {"phpstan/extension-installer": true, "dealerdirect/phpcodesniffer-composer-installer": true} - 避免全局设
true，尤其在共享开发机上——它会绕过所有插件安全校验 - 私有插件必须带完整 vendor/name，不能只写 name；否则即使允许也会被拒绝
这个机制不是“多此一举”，而是防止恶意插件通过 require 注入执行任意代码——2.x 把这件事从“靠人品”变成了“靠配置”。漏掉它，很多基于插件的工具链（比如 PHPStan、PHP-CS-Fixer 集成）会在新环境中静默失效。
