唯一可靠方式是修改composer.json的config.vendor-dir为相对路径并重装；需删旧vendor、改require路径、更新IDE索引及部署脚本，环境变量COMPOSER_VENDOR_DIR仅在无config时生效。
直接改 composer.json 里的 config.vendor-dir，再删掉旧 vendor 重装，是唯一可靠方式。其他方法要么无效，要么只在特定场景下“看起来像生效”。
为什么不能用 composer install -d 或命令行参数改 vendor 路径
-d 参数只影响 Composer 去哪找 composer.json 和 composer.lock，完全不控制依赖写入位置。你在 Laravel 项目里执行 composer install -d /tmp/laravel-test，包依然会装进当前目录下的 vendor（或已配置的 vendor-dir），不是 /tmp/laravel-test/vendor。CI 脚本里滥用这个参数，八成会导致 Class not found。
怎么在 Laravel 项目中安全改 vendor-dir
必须在 composer.json 中提前声明，且只有 vendor 不存在时才真正生效：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 编辑项目根目录的
composer.json，加入"config"段落：{"config": {"vendor-dir": "third-party"}} - 手动删掉现有
vendor目录和composer.lock（仅当你要彻底重装时；若只是首次配置，删vendor即可） - 运行
composer install—— 此时依赖才会真正写入third-party/ - 所有代码中
require 'vendor/autoload.php'必须同步改为require 'third-party/autoload.php' - Laravel 的
artisan不依赖硬编码路径，但如果你在public/index.php或自定义入口里写了require，也得改
COMPOSER_VENDOR_DIR 环境变量适合什么场景
它优先级高于 composer.json 里的配置，适合 CI/CD、Docker 多环境部署等需要动态切换路径的情况：
- Linux/macOS：执行前设
export COMPOSER_VENDOR_DIR="/var/www/myapp/libs" - Docker：在
Dockerfile中加ENV COMPOSER_VENDOR_DIR=/app/libs - 注意：Web 服务器（如 PHP-FPM）启动前必须注入该变量，仅在 shell 里
export对请求无效 - 改了之后，
third-party/autoload.php这类路径仍要按实际值调整，环境变量不自动重写 PHP 代码里的字符串
改完路径后哪些地方容易漏掉
最常被忽略的是 autoload 入口和 bin 工具链的断裂：
-
phpunit、phpcs这些命令默认从vendor/bin/找，你得确保config.bin-dir也同步配成"bin-dir": "third-party/bin" - IDE（如 PHPStorm）不会自动识别新路径，需手动在
Settings → PHP → Include Paths中添加third-party - 某些 Laravel 包的发布命令（如
php artisan vendor:publish）可能仍往vendor/xxx写资源，得看包自身是否读取了vendor-dir配置 -
.gitignore里如果还写着/vendor，记得补上/third-party，否则可能误提交
真正麻烦的从来不是改配置，而是改完之后所有路径引用、工具链、IDE 索引、CI 脚本都得跟着动一遍——少动一处，就卡在某个看似无关的地方。
