composer 2.x 与 1.x 完全不兼容：composer.lock 文件含 plugin-api-version 字段致 1.x 解析失败；classmap-authoritative 默认启用导致动态类加载失效；插件默认禁用需显式配置 allow-plugins。
Composer 2.x 不是 Composer 1.x 的“升级补丁”，而是行为、安全策略和文件格式都不同的新工具——混用会直接导致 composer install 失败、类找不到、插件被拒、CI 构建中断。
composer.lock 文件完全不兼容
Composer 2.x 生成的 composer.lock 含 plugin-api-version 字段（如 "plugin-api-version": "2.2.0"），而 Composer 1.x 解析时会报错：Invalid lock file. Expected key "plugin-api-version" at line X。这不是警告，是 fatal error，安装直接终止。
- 团队共用一个项目时，必须统一 Composer 版本：要么全升到 2.x（推荐），要么全锁在
1.10.25（最后一个稳定 1.x） - CI 流水线必须显式指定版本，例如 GitHub Actions 中用
composer-setup.php安装特定版本，不能依赖系统预装 - 不要手动编辑
composer.lock；若需降级，先用 Composer 1.x 运行composer update --lock再提交
autoloader 行为突变：类突然找不到
Composer 2.x 默认启用 classmap-authoritative，而 1.x 不启用。这意味着：动态注册的监听器（如 Laravel 的 EventServiceProvider）、files 类型加载的运行时拼接路径（如 __DIR__ . '/stubs/' . $name . '.php'），在 2.x 下根本不会被扫描到。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 检查
composer.json是否含"optimize-autoloader": true或"classmap-authoritative": true；若需兼容 1.x，这两项应显式设为false - 开发调试时可用
composer dump-autoload --no-authoritative强制生成非权威 classmap（2.x 支持，1.x 忽略该 flag） - 避免在
files加载中做路径拼接或条件判断——2.x 的 classmap 是静态扫描结果，不执行 PHP 逻辑
插件默认被禁：本地能跑，CI 报 Plugin not allowed
Composer 2.x 默认关闭所有第三方插件（包括 laravel/installer、phpstan/extension-installer），除非你在 composer.json 显式声明 "allow-plugins"；而 1.x 默认全开——这就造成「本地跑得通，CI 报错」。
- 立刻检查
composer.json顶层是否有config.allow-plugins配置；没有就加： "config": { "allow-plugins": { "phpstan/extension-installer": true, "laravel/installer": true } }- 不要写
"allow-plugins": true（过于宽松，CI 安全策略可能拒绝）
最常被忽略的是：composer.lock 和 allow-plugins 这两个点一旦出问题，不是报错信息模糊，而是整个流程卡死——前者让依赖安装失败，后者让脚本钩子失效。别假设“只是版本号不同”，它们是两套逻辑。
