Composer path依赖生效需同时满足：type为"path"、url是合法绝对或相对路径（不以../开头）、目标目录含格式正确的composer.json；否则静默忽略或降级为dist包。
path依赖的JSON格式必须严格匹配Composer规范
Composer读取path类型仓库时，会尝试加载目标目录下的composer.json文件，并校验其结构是否合法。一旦格式错误（比如逗号缺失、引号不闭合、字段名拼错），composer install或composer update就会直接失败，报错类似：Could not load package xxx in https://packagist.org: [UnexpectedValueException] Invalid package information。
实操建议：
- 用
composer validate命令检查本地composer.json——它能捕获语法错误和基础schema违规（如name、version缺失） - 确保
repositories中path配置的url是**绝对路径**或**相对于根composer.json的相对路径**；相对路径不能以../开头（否则会被忽略） -
type字段必须显式设为"path"，不能省略；options下symlink等键值需为布尔值，不能写成字符串"true"
为什么vendor/autoload.php无法加载path包的类
常见原因是autoload配置未生效：Composer只在解析完所有依赖并确认包版本后，才合并autoload规则。如果path包的composer.json里漏了autoload段，或psr-4映射路径与实际文件结构不一致，即使安装成功，类也无法自动加载。
实操建议：
- 在
path包的composer.json中，明确声明autoload，例如："autoload": {"psr-4": {"MyVendor\MyPackage\": "src/"}} - 运行
composer dump-autoload -o强制重生成自动加载映射（尤其在修改autoload后） - 检查
vendor/composer/autoload_psr4.php是否已包含该映射——没出现说明Composer根本没读取到这个包的autoload配置，大概率是name字段不匹配或require声明有误
path依赖被跳过或降级为dist包
Composer默认优先使用dist（zip/tar包），除非显式启用path仓库且满足条件。若path包的name与require中声明的不完全一致（大小写、分隔符差异），或version字段不符合语义化版本格式（如写成"dev-master"但没配minimum-stability），Composer会回退到Packagist上同名包的dist版本。
实操建议：
-
name必须全小写、含单个/（如"myorg/mypackage"），且与require中引用的完全一致 -
version建议用稳定格式（如"1.0.0"）；若用开发版，需在根composer.json中加"minimum-stability": "dev"和"prefer-stable": false - 执行
composer show myorg/mypackage确认当前安装的是path源而非dist源——输出中应含source字段，且type为path
如何调试path依赖的实际解析路径
Composer不会把path仓库的物理位置暴露在常规命令输出里，但可通过-v（verbose）模式观察加载过程。最直接的方式是临时修改Composer源码或使用composer diagnose配合日志。
实操建议：
- 运行
composer update -v myorg/mypackage，查看输出中是否有Loading from path repository及对应路径 - 若路径显示为
../../local-packages/mypackage但实际不存在，说明相对路径计算出错——改用__DIR__ . '/local-packages/mypackage'这类PHP常量方式在repositories.url中定义（需用脚本动态生成composer.json） - 注意Windows路径分隔符：用
/或\均可，但避免混用；file://前缀不被支持，不要加
路径配置本身没有魔法，关键在于三个文件的协同：根composer.json的repositories和require、path包自身的composer.json、以及vendor/composer/installed.json中最终记录的源类型。任一环节的字段名、路径、版本字符串稍有偏差，就会静默失效。
