composer install 会拒绝继续执行，因为 composer 将 vendor/ 视为只读快照，检测到任何本地修改（如编辑 vendor 中文件）即中断并提示丢弃更改，这是防止意外覆盖的保护机制，必须显式使用 --discard-changes 参数才能强制按 composer.lock 还原。

直接运行 composer install 不会覆盖你手动改过的 vendor/ 文件，它会报错卡住——必须显式告诉 Composer “丢弃本地修改”。

为什么 composer install 会拒绝继续执行

Composer 默认把 vendor/ 当作只读快照。一旦检测到某个包的文件被编辑过（比如你改了 vendor/symfony/console/Command.php），它就会中断并提示类似：
Package vendor/package is not up to date. Changes will be discarded. 或更直白的 There are uncommitted changes in vendor/package。
这不是 bug，是保护机制：防止你本地魔改后，install 覆盖掉却没意识到。

必须加 --discard-changes 才能强制恢复

这个参数不是开关，而是明确的操作指令，只在当前命令生效：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• composer install --discard-changes：按 composer.lock 完整还原，所有手动改写一律丢弃
• composer update --discard-changes：先更新依赖再丢弃修改（慎用，会改 composer.lock）
• 不加该参数时，哪怕只改了一个 .md 文件，install 也会停住，不会自动跳过
• 注意：它不会删掉整个 vendor/ 再重拉，而是对每个包做“diff + reset”，所以比 rm -rf vendor && composer install 快

常见误操作和替代方案

别指望 composer dump-autoload 或 composer clear-cache 解决这个问题——它们不碰 vendor/ 文件内容本身。

• 想保留部分修改？先 git stash 或复制出来，再运行带 --discard-changes 的命令
• 误删了 vendor/ 但没动任何文件？直接 composer install 就行，不需要加参数
• 用 IDE 自动保存时不小心改了 vendor/？建议给 vendor/ 目录设为只读（VS Code 可装 Read Only Files 插件），从源头避免
• CI/CD 流水线里出现这问题？检查是否有人提交了 vendor/ 到 Git —— 它本不该进版本库

修复后仍报 Class not found？检查 autoload 是否失效

即使 vendor/ 恢复了，vendor/autoload.php 也可能因路径或缓存问题不工作：

• 确认当前工作目录是项目根目录（含 composer.json），否则 require 'vendor/autoload.php' 会找错位置
• 运行 composer dump-autoload -o 强制重建优化后的自动加载映射
• 如果用了自定义 autoload 规则（如 psr-4 映射），改过 composer.json 后必须 dump-autoload，光 install 不管用

真正麻烦的不是报错本身，而是你改过哪些文件、改了什么、有没有备份——Composer 不记录这些，--discard-changes 是一把双刃剑，用前心里得有数。