vendor目录改后类找不到，主因是代码中require 'vendor/autoload.php'未同步更新为新路径，且ide、脚本、bin命令等均需手动适配新路径或改用符号链接方案。
vendor-dir 改了但类找不到，autoload.php 路径没同步更新
改 config.vendor-dir 后最常踩的坑是代码里还写 require 'vendor/autoload.php'。Composer 不会自动帮你改这行——它只管生成新路径下的 autoload.php，而你的入口脚本、测试文件、甚至框架 bootstrap 都可能硬编码旧路径。
必须手动检查并替换所有类似引用：
-
require 'vendor/autoload.php'→ 改成require 'third-party/autoload.php'（假设你设的是"vendor-dir": "third-party"） - PHP CLI 脚本中用到的
vendor/bin/phpunit要同步改成third-party/bin/phpunit - Laravel 的
artisan若被重命名或封装过，也要确认其内部是否仍依赖vendor/autoload.php
IDE 识别不到新 vendor 目录，补全和跳转失效
PhpStorm、VS Code 等工具会缓存 vendor 路径，哪怕你已改完 composer.json 并重装，它们仍按旧路径索引。这不是 Composer 的问题，而是 IDE 没刷新上下文。
解决方法很直接：
- PhpStorm：菜单 File → Reload project from Disk，或右键项目根目录 → Reload project
- VS Code + PHP Intelephense：按
Ctrl+Shift+P→ 输入Intelephense: Index workspace手动触发重建 - 别信“自动检测”，尤其在 Docker 或远程开发场景下，必须显式刷新
post-install-cmd 脚本执行失败，因为 bin 文件位置变了
很多项目在 composer.json 的 scripts 里写了类似 "post-install-cmd": ["php vendor/bin/phpunit --version"] 的命令。vendor 路径一变，vendor/bin/ 就不存在了，脚本直接报错 Command not found。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
不能只改配置，还得修脚本：
- 把所有
vendor/bin/xxx替换为${COMPOSER_VENDOR_DIR}/bin/xxx（Composer 1.10+ 支持该环境变量） - 或者统一用
php -d allow_url_fopen=1 -d disable_functions= -d memory_limit=-1 "$(pwd)/third-party/bin/phpunit"这类绝对路径调用 - 更稳妥的做法是避免硬编码路径，在脚本里先判断：
if [ -f third-party/bin/phpunit ]; then php third-party/bin/phpunit; fi
符号链接方式迁移比改 vendor-dir 更可靠
硬改 config.vendor-dir 是个半吊子方案：它影响 autoload、bin、插件行为，但不保证所有第三方工具兼容（比如某些 CI 插件、部署脚本、安全扫描器默认只认 vendor/）。真正想物理隔离，应该保持默认路径，再用符号链接绕过去。
操作顺序不能错：
- 先运行
composer install --no-scripts，确保 vendor 正常生成且不触发任何路径敏感脚本 - 确认外部目录存在且权限正确：
mkdir -p /opt/shared/vendor && chown $USER:$USER /opt/shared/vendor - 删除原
vendor并创建链接：rm -rf vendor && ln -s /opt/shared/vendor ./vendor - 最后补一句
composer dump-autoload -o，让 autoload 映射指向真实路径
这个做法绕开了所有 vendor-dir 的副作用，连 IDE 和 CI 工具都无需额外适配——它们看到的还是 vendor/，只是内容在别处。唯一要注意的是 Docker 构建时得挂载好宿主机路径，并加 --cap-add=SYS_ADMIN 才能建 symlink。
