唯一可靠的方式是修改composer.json中的config.vendor-dir为{"config": {"vendor-dir": "third-party"}}，路径须为相对路径，改后需删除旧vendor并重新执行composer install，同时手动更新所有require路径、ide索引及部署脚本。
怎么让 Composer 把包装进 third-party 而不是 vendor
唯一可靠的方式是改 composer.json 里的 config.vendor-dir，其他方法基本无效。
- 必须在项目根目录的
composer.json中写入：{"config": {"vendor-dir": "third-party"}}路径必须是相对路径（third-party✅，/third-party❌） - 改完后要手动删掉旧的
vendor目录，再执行composer install—— 否则旧文件还在，autoload 不会重建 -
composer dump-autoload不会挪目录、不改autoload.php路径，纯属白忙 - 所有 PHP 代码里硬写的
require 'vendor/autoload.php'都得改成require 'third-party/autoload.php' - IDE（如 PHPStorm）默认只索引
vendor，得手动在 Settings → PHP → Include Paths 里加新路径
为什么 COMPOSER_VENDOR_DIR 环境变量没用
它只在项目没声明 config.vendor-dir 时才生效；一旦 composer.json 里写了，环境变量就被忽略。
-
COMPOSER_VENDOR_DIR=lib composer install在大多数场景下静默失效，别依赖它 -
-d参数（如composer -d /path install）只影响 Composer 查找composer.json的位置，不控制安装路径 - 想临时换路径？不如直接删 vendor + 改 config + 重装，更可控
怎么确保 composer install 用的是宝塔里设的 PHP 8.2 而不是系统默认的 PHP 7.4
宝塔网站设置的 PHP 版本和终端里跑的 Composer 完全无关，必须显式指定解释器路径。
- 先确认目标 PHP 路径存在：
/www/server/php/82/bin/php（注意是82，不是8.2） - 不要用
php composer.phar install，要用：/www/server/php/82/bin/php /usr/local/bin/composer install - 嫌命令太长？加个 alias（仅当前 shell 生效）：
alias c82='/www/server/php/82/bin/php /usr/local/bin/composer'，之后用c82 install - 别动
/usr/bin/php软链——宝塔靠它管理多版本，一改可能崩面板后台 - 验证是否真用了对的版本：在命令末尾加
-v，看输出里 “PHP version” 是不是你想要的
权限问题导致 composer install 写不进 third-party
常见报错是 Permission denied，本质是当前终端用户（如 root）和 Web 服务用户（www）权限不一致。
- 宝塔默认用
www用户跑 PHP 进程，但你终端登录可能是root或普通用户 - 执行前先统一属主：
chown -R www:www /www/wwwroot/your-site.com/third-party - 别只 chmod 755，
third-party和子目录得是755，里面生成的文件得是644，可执行脚本（如 bin 下的）得是755 - 如果用了宝塔「网站」→「配置」→「运行目录」功能，确保该目录对
www用户可读写
vendor-dir 却忘了同步改 require 路径、IDE 设置、CI 脚本，或者以为改了环境变量就万事大吉——结果 install 没报错，但 autoload 就是不加载。
