本地包冲突的根本原因是Composer将其视为已发布包并严格校验其composer.json中的conflict、require、php及minimum-stability等约束，而非路径错误；vcs仓库因惰性解析不立即触发这些校验。
本地包（path repository）引入后报 conflict 或无法解析，根本原因不是路径写错了，而是 Composer 把它当成了“远程包的等价替代”，仍严格校验其 composer.json 里的 require、conflict 和 php 约束——和你本地 PHP 版本、已装依赖完全无关。
为什么 path 包会触发冲突，而 vcs 不会？
Composer 对 path 类型仓库的处理逻辑是：先读取目标目录下的 composer.json，然后把它当作一个“已发布包”参与整棵树的 SAT 求解。这意味着：
- 它里面的
"conflict": {"laravel/framework": ">=11.0"}会全局生效，哪怕你项目没装 L11，只要其他依赖间接拉进一个带 L11 声明的包，就直接失败 - 它的
"require": {"php": "^8.2"}会强制要求当前环境 PHP ≥ 8.2，即使你只是想本地调试 - 它声明的
"minimum-stability": "dev"会影响整个项目的稳定性策略，可能把原本稳定的monolog/monolog拉成dev-main -
vcs仓库默认走 tag/branch 解析，不直接读取开发分支的composer.json，所以约束更“惰性”
composer why-not 查不到本地包的阻断链？
这是常见错觉。实际上 composer why-not 能查，但必须用它在 path 包里声明的 name（不是路径），且该包得已出现在 composer.lock 的 packages-dev 或 packages 列表中。如果还没成功解析进锁文件，why-not 就无从下手。
正确做法是：
- 先确认
path包是否被识别：运行composer config repositories，看输出里有没有你的路径条目 - 确保
composer.json里require的 key 和path包的"name"完全一致（包括 vendor 名，比如"acme/utils"，不能写成"utils"） - 临时删掉
composer.lock，再跑composer update --dry-run -v，观察日志里是否出现Loading package acme/utils from path repository—— 没这句说明路径根本没加载 - 如果仍卡住，加
--verbose看最后一段 “Resolving dependencies” 的回溯，常能看到类似Trying acme/utils dev-main后立刻Backtracking，这就是它在composer.json里撞上了某个conflict
怎么让本地包“绕过”自己的 conflict 和 php 约束？
不能真绕过，但可以精准干预。关键不是改命令参数，而是改本地包的 composer.json 本身：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 开发阶段临时删掉或注释掉
"conflict"字段 —— 它不是提示，是硬拦截，留着就等于主动拒绝自己 - 把
"require": {"php": "^8.2"}改成"require": {"php": ">=7.4.0"}，或干脆删掉（Composer 默认只校验最低版本，不强制上限） - 如果本地包用了
"replace"，确认被替换的包确实已安装且版本兼容，否则运行时会Class not found - 不要在
path包里写"minimum-stability": "dev"，改用主项目根目录的composer.json统一控制："minimum-stability": "stable", "prefer-stable": true - 改完立刻跑
composer update acme/utils --with-dependencies，别用全量update，避免其他包被连带重算
路径引用后 vendor/autoload.php 找不到类？
这不是 Composer 冲突，是 autoloading 配置未生效。本地包的 autoload 段（如 "psr-4": {"Acme\": "src/"}）必须被主项目识别并合并，而它只在 composer dump-autoload 时写入生成器。
检查点：
- 运行
composer show acme/utils，确认输出里有Autoload行，且路径指向正确子目录 - 执行
composer dump-autoload -o（优化模式），它会重新扫描所有包的 autoload 配置并合并到vendor/composer/autoload_psr4.php - 如果仍不行，手动检查
vendor/composer/autoload_psr4.php，看是否有"Acme\" => array($vendorDir . '/acme/utils/src')这样的映射 —— 没有就是composer.json里的autoload段格式错了，比如漏了末尾逗号或引号不匹配 - 别用
require-dev引入生产用的本地包，require-dev下的 autoload 默认不启用，除非你明确加了--dev参数
最易忽略的一点：本地包的 composer.json 里写了 "autoload-dev"，但主项目 require 它时没启用 dev 模式，导致测试类能加载、业务类反而找不到——这种错不会报 conflict，只会静默失败。
