Composer install/update 时应使用 --force 参数跳过 vendor 文件校验直接覆盖，该参数在 Composer 2.2+ 正式支持，可避免因本地修改导致的中止报错，但会强制重新下载所有包。
Composer install/update 时跳过 vendor 文件校验直接覆盖
默认情况下，Composer 发现 vendor/ 下某包的文件被本地修改过（比如调试时改了源码），会中止操作并报错：Changed files detected...。这不是“保护”，而是防止你意外丢掉手动改动——但多数时候，你就是要丢掉它，用上游代码覆盖回来。
根本解法是告诉 Composer：别看这些改动，直接按 composer.lock 重装。关键参数是 --force：
composer install --force
composer update --force
注意：--force 在 Composer 2.2+ 才正式支持；旧版本（如 1.x）需改用 --no-scripts --no-plugins + 删除 vendor/ 手动重装，不推荐。
为什么 git stash 不解决这个问题
有人试过在 vendor/ 里执行 git stash，发现没用——因为 Composer 不依赖 Git 状态判断文件是否被改，它直接比对文件哈希与 composer.lock 记录的 dist source 或 commit hash。哪怕你 git stash 了，文件内容变了，校验就失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
vendor/下的包不一定用 Git 克隆（可能是 zip 下载） - 即使用了 Git，Composer 也不读
git status，只读实际文件内容 - 所以别折腾
git stash，直接上--force
composer update --force 的副作用要留意
--force 不仅跳过改动检查，还会强制重新下载所有包（即使 composer.lock 没变），相当于加了隐式 --no-cache 行为。这意味着：
- 网络差时会明显变慢（尤其国内没配镜像源）
- 如果锁文件里有 private package，且认证已过期，
--force可能触发 401 报错 - 不会跳过脚本（
post-install-cmd等仍会执行），这点和--no-scripts无关
若只想覆盖改动、又不想重下包，可先删掉出问题的目录再跑 composer install，例如：
rm -rf vendor/monolog/monolog && composer install
长期避免这类问题的配置建议
频繁手动改 vendor/ 代码，本质是开发流程缺陷。更可持续的做法：
- 用
composer patch（配合cweagans/composer-patches插件）管理补丁，而非直改文件 - 调试时优先用 Xdebug 断点或
dump()，而不是改 vendor 源码 - 真要改底层逻辑，应 fork 对应包、提交 PR、然后用
"package-name": "dev-main as 1.2.3"引入自己的分支
硬覆盖只是救火手段，不是常态方案。每次敲 --force 都该提醒自己：这里是不是该换个更可维护的解法？
