Composer install 中止是因 vendor 下存在未提交修改，属保护机制；应使用 --discard-changes 强制还原，而非 rm -rf vendor。
vendor目录里有未提交修改，composer install直接中止
这是 Composer 的保护机制，不是 bug。只要 vendor/ 下任意包里存在未提交的改动（比如你手改过一个 README.md 或加了 dump() 调试），composer install 就会停住，报类似 There are uncommitted changes in vendor/package 的错误。
它不会跳过、不会提示“是否覆盖”，而是明确 halt——因为 Composer 把 vendor/ 当作只读快照，不是你的工作区。
- 唯一安全的强制还原方式是加
--discard-changes：运行composer install --discard-changes，它会按composer.lock精准重置每个包，比rm -rf vendor && composer install更快，且保留 autoload 缓存结构 -
composer update --discard-changes会先更新依赖再丢弃修改，会改composer.lock，慎用 -
composer dump-autoload或clear-cache完全不解决这个问题，它们根本不碰vendor文件内容
某个包的 vendor 目录被一起打包进来了
这说明上游包在发布时把自身的 vendor/ 子目录错误地塞进了发行包，典型表现是：进入 vendor/some/package/ 后发现里面还有个 vendor/，甚至嵌套好几层。
这不是兼容性问题，是发布污染——会导致自动加载冲突、重复引入同名类、安全风险（比如不同版本的 symfony/console 被同时加载）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 第一步确认来源：用
composer show --tree找可疑包，再手动进对应目录看有没有vendor/子文件夹 - 优先联系维护者修复：请他们在
.gitattributes加/vendor export-ignore，发布前执行git clean -fdx && composer install --no-dev模拟干净环境 - 临时方案仅限兜底：在项目
composer.json里用"replace"声明该包已由其他方式提供；或"repositories"指向 fork 后删掉vendor/的修复版；手动删vendor/包名/vendor/必须写入部署脚本并定期检查，否则下次install会恢复
全局 composer global 和项目 vendor 冲突导致类找不到
当全局装了 phpunit/phpunit，项目又 require 了不同版本，PHP 可能加载错版本的类，报 Class not found 或 Cannot redeclare。
根本原因是全局和项目 vendor/ 的自动加载路径都进了 include_path，而 PHP 不支持同名类多版本共存。
- 日常开发应彻底弃用全局工具：运行
composer global remove phpunit/phpunit laravel/installer，改用项目级安装 +composer require --dev - 调用时统一走
./vendor/bin/phpunit，而不是全局命令；可通过scripts字段定义"test": "phpunit"，然后用composer test - 若必须全局使用，推荐换
phive管理 PHAR 工具（如phive install php-cs-fixer），它完全隔离，不走 Composer autoloader
私有库发版时锁死了底层依赖版本
私有 SDK 的 composer.json 里写了 "guzzlehttp/guzzle": "7.4.5" 这种精确版本，等于给所有下游项目上锁——只要另一个包要 ^7.5 或 ^8.0，Composer 就无解。
私有库不是封闭系统，它的约束必须为下游让路，而不是反过来要求项目迁就。
- 正确写法是语义化范围：
"guzzlehttp/guzzle": "^7.4 || ^8.0"（前提是代码真兼容），更稳妥的是只写"^7.4"并靠 CI 覆盖多版本验证 -
composer why-not必须在私有库根目录下运行，否则查不到它自己composer.json里的真实约束；在主项目里跑只会看到无关路径 - 私有库的
composer.json别设minimum-stability或prefer-stable，让它继承主项目的策略；发布必须打 Git tag（如v2.3.0），别用dev-main顶替
vendor 就干净了，但全局 ~/.composer/vendor、shell 的 PATH 里残留的旧二进制、甚至 Docker 构建缓存里的旧层，都可能悄悄参与加载。动手前先确认当前命令到底从哪来——which phpunit、composer global show、php -i | grep include_path，比盲目重装更省时间。 
