vendor被手动修改后composer install报错，必须使用--discard-changes参数强制按composer.lock还原，否则会中止执行；该参数明确丢弃所有本地修改，不区分文件类型，且不会提示具体覆盖内容。
vendor里改过文件，composer install直接报错怎么办
Composer 不会“覆盖”你手动改过的 vendor 文件，而是直接中止安装并报错。这不是卡住，是明确拒绝执行——只要 vendor/package-name 下存在未提交的 Git 修改（哪怕只是改了 README.md），就会停在：
“The package vendor/package has modified files. Changes will be discarded. Use --discard-changes to overwrite.”
它不区分代码还是文档，也不判断你改的是否关键，整个目录被视为不可信状态。
常见错误现象：
• composer install 一运行就中断，提示 uncommitted changes
• CI 流水线里反复失败，但本地 git status 看不到脏文件（其实是子模块或嵌套 Git 仓库）
• 误以为 composer dump-autoload 或 clear-cache 能解决——它们完全不碰 vendor 文件内容
真正能用的只有：
• composer install --discard-changes：丢弃所有本地修改，按 composer.lock 重置 vendor
• composer update --discard-changes：先更新依赖树再丢弃修改——风险更高，慎用
注意：--discard-changes 不是“保留你的改动再覆盖”，而是彻底删除你改的每一行，且不会告诉你哪些文件被覆盖了
想重装包但不想删 vendor 或改 lock，该用哪个命令
用 composer install --force-reinstall。它专为这种场景设计：不删 vendor/ 目录、不改 composer.lock，但强制对每个包执行卸载 + 重装流程——文件被覆盖、autoload 重建、post-install-cmd 脚本也会重跑一遍。
为什么不用 rm -rf vendor && composer install？
• 前者更快：保留 autoload 缓存结构，避免重建整个映射树
• 更精准：只重装 composer.lock 里声明的包，不触发额外下载或解压
• 可复现：lock 不变，结果确定，适合 CI/CD 中修复偶发损坏
必须注意的前提：
• composer.lock 必须已同步最新——如果 composer.json 改了但没运行 composer update --lock-only，--force-reinstall 仍装旧版
• Windows 下容易因文件被占用失败，需先关掉 Swoole/Xdebug/PhpStorm 索引服务
• 若只想重装生产依赖，加 --no-dev；若某些间接依赖没被覆盖，加 --with-all-dependencies
安装中断后再次运行失败，怎么补救
中断不是“锁坏了”，而是 composer.lock 和实际 vendor/ 状态不一致，导致 content-hash 校验失败。此时 composer install 会直接退出，报类似 “Package xyz has a mismatched hash” 或静默失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
别急着删 vendor：
• 先试 composer install --no-scripts --no-plugins：跳过 autoload 生成和脚本执行，专注把 vendor/ 按 lock 补全干净
• 这招对网络抖动、Ctrl+C 中断、PHP 内存溢出等常见中断最有效
• 如果仍失败，再清理：
rm -rf vendor（Windows 用 rmdir /s vendor）
composer clear-cache
composer install
特别提醒：
• composer update 更危险——它会重算整棵树，可能把已装好的稳定包升级到不兼容版本
• 镜像源问题占国内中断案例 80% 以上，换阿里云镜像（composer config -g repo.packagist https://mirrors.aliyun.com/composer/）比调参数更治本
冲突报错说“requirements could not be resolved”，怎么定位真问题
这不是版本没对上，而是依赖图里存在无法同时满足的约束。错误末尾的 “Root composer.json requires…” 是表象，真正挡路的往往是下游间接依赖。
第一步永远是：
• composer why-not target/package:version，比如 composer why-not guzzlehttp/guzzle:7.9.0
输出会直接告诉你谁在拦，例如：
myapp/core v2.3.1 requires guzzlehttp/guzzle ^6.5
说明冲突不在 guzzle 本身，而在版本范围无交集
容易忽略的点：
• require-dev 里的包（如 phpunit/phpunit）可能悄悄拉进不兼容的 symfony/console
• platform 配置（如 "php": "8.1.0"）参与约束求解，和实际环境不一致时会误判
• composer depends 查“谁依赖它”，composer why 才查“为什么它被装进来”——别用反
盲目 --ignore-platform-reqs 或 --force 只会把问题推迟到运行时报错（比如 Call to undefined method），不是真解决
