Composer path依赖加载失败的主因是path包autoload未合并到根项目：需确保repositories声明正确、path包含匹配name的composer.json、其autoload配置有效，并在根项目执行composer dump-autoload强制重生成autoload映射。
Composer path 依赖加载失败的典型现象
运行 composer install 或 composer dump-autoload 后，PHP 报错类似：Class 'App\SomeClass' not found，但类文件明明在 vendor/myorg/mypackage/src/ 下，且 composer.json 中已配置了 "autoload": { "psr-4": { "App\": "src/" } } —— 这说明 Composer 没把 path 类型的包纳入自动加载逻辑，不是代码写错了，而是路径映射没生效。
确认 path 包是否被正确识别为本地开发包
Composer 只对 repositories 中声明为 "type": "path" 且满足路径存在、含有效 composer.json 的包启用 symlink 行为。常见漏点：
-
repositories声明位置错误：必须放在根项目（即你执行composer install的那个项目的）composer.json中，不能放在被引用的 path 包内部 - 路径值是相对路径，但相对于的是根项目目录，不是当前工作目录；例如
"url": "../mypackage"要求mypackage/和根项目在同一级父目录下 - path 目录下缺少
composer.json，或其中name字段与根项目require中写的不一致（大小写、命名空间分隔符都需完全匹配）
检查 autoload 是否真正包含了 path 包的命名空间
即使 path 包被识别并软链接进 vendor/，它的 autoload 配置默认不会自动合并到根项目的 autoloader 中。必须手动触发：
- 确保 path 包的
composer.json里有正确的autoload块（如"psr-4": { "MyOrg\MyPackage\": "src/" }） - 在根项目中运行
composer dump-autoload --optimize（或至少composer dump-autoload），强制重新生成vendor/autoload.php并读取所有 vendor 下包的 autoload 配置 - 验证生成结果：打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，确认对应路径已写入（例如'MyOrg\MyPackage\' => array($vendorDir . '/myorg/mypackage/src')）
Windows 下 symlink 权限和路径大小写问题
Windows 默认禁用开发者模式时，composer install 对 path 包会 fallback 到 copy 模式，导致修改源码不生效，且 autoload 路径指向的是 copy 出来的副本（路径可能含空格或特殊字符，引发解析失败）：
- 开启 Windows 开发者模式，或在管理员权限的终端中运行
fsutil behavior set SymlinkEvaluation L2L:1 R2R:1 L2R:1 R2L:1 - 更稳妥的做法：在 path 包的
composer.json中显式加"options": { "symlink": true }，并确保根项目composer.json的config中未设置"preferred-install": "dist"（它会压制 symlink） - Windows 文件系统不区分大小写，但 Composer autoload 生成的数组键是严格区分大小写的；如果 path 包的
autoload命名空间写成"myorg\mypackage\"（小写），而代码中use MyOrg\MyPackage...（大写），就会找不到类
path 依赖的 autoload 生效链路比常规包更脆弱——它依赖路径可达性、symlink 权限、命名空间拼写一致性、以及两次 autoload 重建（一次是包自身，一次是根项目 dump）。最容易被跳过的其实是最后一步：改完 path 包的 composer.json 后，忘了在根项目再跑一遍 composer dump-autoload。
