Composer 无法直接加载 vendor 外部路径的类，需通过 autoload 配置（如 psr-4）将其纳入自动加载体系，或使用符号链接“欺骗”Composer，手动 require 仅适用于无命名空间的临时场景。
不能直接让 Composer 把类加载到 vendor 外部路径——它生成的自动加载器（vendor/autoload.php）默认只认 vendor 里装的包，以及你在 composer.json 中明确声明的本地路径映射。所谓“加载 vendor 外部的类”，本质是两种需求：要么把外部目录“纳入” Composer 的自动加载体系，要么绕过 Composer、手动引入。前者可行且推荐，后者容易出错。
怎么用 autoload 配置加载 vendor 外的自定义类
这是最常见也最稳妥的做法：你有一堆自己写的类（比如在 ../shared-libraries/utils），想让它们像 vendor 包一样被 use 调用。关键不是移动 vendor，而是告诉 Composer “这些路径下的类我也要管”。
-
psr-4是首选，要求命名空间与目录结构严格对应，例如："autoload": { "psr-4": { "SharedLib\": "../shared-libraries/utils/" } }注意路径必须是相对于composer.json所在位置的相对路径，且该路径需存在、可读 - 改完后必须运行
composer dump-autoload，否则配置不生效；加-o可生成优化版映射（适合生产） - 不要混用
psr-0（已废弃）或在同一个命名空间下交叉配置classmap和psr-4，会导致类找不到 - 如果外部路径含符号链接，Linux/macOS 下一般没问题；Windows 默认会复制而非链接，可能引发热更新失效
为什么不能用 vendor-dir 指向项目外目录
vendor-dir 看似能“挪走” vendor，但它只接受项目内部的相对路径（如 ../libs），不能指向 /opt/my-vendor 或 C:global endor 这类绝对系统路径。强行设置会触发以下问题：
-
composer dump-autoload生成的autoload_static.php里写死的是相对路径引用，一旦跨项目根目录，require就会失败 - 第三方包自身的
autoload配置（如 Guzzle 的"psr-4": {"GuzzleHttp\": "src/"}）依赖 vendor 目录为基准解析，移出去后所有类都加载不到 - 插件（如
composer-plugin-api）和脚本（scripts）在执行时会假设vendor/bin、vendor/autoload.php在约定位置，路径错位即中断 - CI/CD 流程、Docker 构建中若未同步修改路径变量，构建大概率失败
符号链接方案：让 vendor “看起来在项目内，实际在外部”
如果你真需要多个项目共用一份包文件（比如统一维护的私有工具集），符号链接是唯一轻量且兼容性好的方式。它欺骗 Composer，让它以为 vendor 还在原位，而真实文件存于别处。
- 先创建外部目录，如
/shared/my-project-vendor，确保当前用户有读写权限 - 删除项目内原有
vendor目录 - Linux/macOS 执行：
ln -s /shared/my-project-vendor ./vendor；Windows（管理员）执行：mklink /D vendor C:sharedmy-project-vendor - 之后所有
composer install都会操作这个外部目录，但vendor/autoload.php的路径逻辑完全不变 - 风险点：多个项目共用同一
vendor时，若各自composer.json依赖版本冲突，安装会报错；上线前务必验证各项目是否真能共存
手动 require 外部类文件的适用边界
仅当你明确不需要命名空间、不参与自动加载、也不打算被其他 Composer 包引用时，才考虑手动 require。比如一个部署脚本临时调用某个外部工具类。
- 必须用绝对路径或基于
__DIR__的可靠相对路径，避免因getcwd()变化导致失败 - 不能替代
vendor/autoload.php—— 如果你还用了 Guzzle 或 Symfony 组件，仍得先require自动加载器 - 无法享受 PSR-4 的命名空间解析，也不能被
class_exists()或 IDE 自动补全识别 - 调试时容易遗漏依赖顺序，比如在
vendor/autoload.php之前require了某个类，而该类又依赖 Guzzle，就会报错
真正难处理的不是“怎么加载”，而是“谁负责维护路径一致性”——无论是 autoload 映射、符号链接，还是 CI 脚本里的路径硬编码，只要有一处没同步，Class not found 就会在最意想不到的时候出现。
