Composer路径错误本质是多层路径优先级混乱与废弃配置导致的连锁失效，需先定位vendor-dir配置层（环境变量COMPOSER_VENDOR_DIR优先级最高，config.vendor-dir已废弃），再同步更新require语句、IDE索引、CI脚本及工具链路径。
Composer 路径错误不是“找不到文件”那么简单，而是多个路径层叠作用、优先级隐晦、且部分配置已废弃导致的连锁失效。直接改 composer.json 或删 vendor 往往没用，得先分清是哪一层路径出了问题。
怎么判断是 vendor 目录路径错配？
典型现象：运行 composer install 后 vendor 仍出现在项目根目录，或报错 require(): Failed opening required 'vendor/autoload.php'，但你明明在 composer.json 里写了 "vendor-dir": "lib/vendor"。
- Composer 2.0+ 已完全废弃
config.vendor-dir字段——设了会触发警告：The "config.vendor-dir" option is deprecated，且不生效 - 真正起作用的是环境变量
COMPOSER_VENDOR_DIR，它优先级最高，覆盖所有配置 - 临时验证：运行
COMPOSER_VENDOR_DIR=./libs composer install，看libs/是否被创建；若成功，说明问题就卡在环境变量没设或设错 - 不要依赖
composer dump-autoload来“修复路径”，它只重生成自动加载逻辑，不挪动任何文件
autoload.php 加载失败时该查什么？
代码里写 require 'vendor/autoload.php'; 却报错，不一定是路径配置错，更可能是加载路径写死了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 一旦改了
COMPOSER_VENDOR_DIR，所有require语句必须同步改成绝对路径或动态拼接，例如：require __DIR__ . '/libs/autoload.php'; -
composer.json中的autoload配置（如psr-4）本身不依赖vendor位置，它只管类名到文件路径的映射，所以这部分通常不用动 - IDE（如 PHPStorm）可能缓存旧
vendor的符号索引，需手动执行File → Reload project from Disk或清空索引 - 部署脚本或 CI 配置里硬编码了
vendor/autoload.php，必须同步更新为新路径，否则运行时仍会失败
全局配置和项目配置混用时的坑
用 composer config --global 改了镜像或缓存路径，结果项目里 composer install 还是从 Packagist 慢速拉包？那很可能是配置作用域错了。
-
composer config --global repos.packagist才能换全局镜像；漏掉--global（或-g）会误写进当前项目的composer.json，而项目级repos默认被忽略，除非显式加"packagist.org": false -
cache-dir、data-dir等路径类配置，受COMPOSER_HOME影响——它优先于~/.composer，且会连带改变缓存、日志、全局 bin 的位置 - 运行
composer config --global --list第一行输出才是真实生效的全局配置路径，别凭经验猜~/.composer/config.json - PHP 版本错配也常被当成路径问题：比如
php -v是 8.2，但composer install报enum语法错误，大概率是PHP_BINARY指向了旧版 PHP，跟路径无关
最易被忽略的点：路径变更后，所有外部工具链（PHPStan、Psalm、CI 脚本、Dockerfile 的 COPY 指令）都得显式适配新路径，不是 Composer 自己“知道”要改——它只负责生成文件，不负责通知别人去哪找。
