vendor冲突本质是自动加载器失效与版本不一致，根本解法是统一composer.lock、PHP环境及platform配置，禁用直接复制vendor。
vendor 冲突不是“能不冲突”的问题，而是“为什么冲突”和“谁在加载”的问题。根本解法不是绕过 autoload，而是让 Composer 明确知道该用哪一份代码。
为什么 vendor 目录复制或共享后 Class not found？
错误现象：Class 'MonologLogger' not found 或 Cannot declare class SymfonyComponentConsoleApplication；常见于复制 vendor、挂载宿主机 vendor、或多个项目共用同一目录后。
根本原因不是文件缺失，而是自动加载器失效：
-
vendor/autoload.php里硬编码了__DIR__，符号链接或跨路径加载时，require的实际路径错位，导致 PSR-4 映射指向空目录 - 不同项目依赖同一包的不同版本（如
guzzlehttp/guzzlev7.5 和 v8.0），共享 vendor 后只保留一个版本，另一方类加载必然失败 -
composer install --no-autoloader后忘了手动dump-autoload，或没显式require正确的 autoload 文件
如何安全地复用已安装的 vendor？
适用场景：本地开发中想避免重复下载、CI 中加速构建、或虚拟机内复用宿主机依赖。
可行做法只有两类，且必须配合环境约束：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
COMPOSER_VENDOR_DIR指向统一路径（如/vagrant/vendor），并在所有环境中确保：composer.lock完全一致、PHP 版本与扩展匹配、运行composer install --no-scripts --no-dev - 在 Dockerfile 中分层 COPY：
COPY composer.json composer.lock ./→RUN composer install --no-dev --optimize-autoloader，利用镜像 layer 缓存，而非共享 vendor 目录 - 绝对不要直接
cp -r或rsyncvendor 到另一台机器——里面含平台相关二进制（如phpunit）、绝对路径 autoloader、以及 symlink 行为在 Windows/macOS/Linux 上表现不一
多个子模块需要共用主项目 vendor 怎么办？
典型场景：WordPress 插件目录、Laravel 包模块、或微前端 PHP 后端聚合服务，每个子目录有独立 composer.json。
正确路径是放弃“合并 vendor”，改用 Composer 原生机制对齐加载上下文：
- 所有子模块不单独执行
composer install，只保留composer.json；主项目composer.json中用"autoload": { "psr-4": { "PluginFoo\": "plugins/foo/src/" } }显式声明路径 - 主项目运行
composer install --no-autoloader && composer dump-autoload，生成唯一vendor/autoload.php，覆盖全部命名空间 - 子模块若含私有依赖，必须通过
pathrepository 注册到主项目，而非各自require，否则composer update会报Root package cannot require itself
同步两个项目的 vendor，最稳的操作是什么？
不是复制文件，而是复制可重现的安装指令和约束快照。
步骤极简但不可跳过：
- 确认源项目已提交
composer.lock（不是仅composer.json） - 目标项目根目录下执行：
cp ../source-project/composer.lock ./ && cp ../source-project/composer.json ./ - 运行：
composer install --no-dev --optimize-autoloader（生产环境）或composer install（开发环境） - 检查
composer show --tree | head -20输出是否与源项目一致；不一致就说明 PHP 版本、platform 配置或插件状态有隐性差异
真正容易被忽略的是 config.platform ——它藏在 composer.json 里，却决定依赖解析结果。哪怕只差一个小数点（如 "php": "8.1" vs "php": "8.1.0"），composer install 就可能拉下不同分支的包。
