path类型需指向含合法composer.json的目录，且其中name必须与require包名完全一致；支持相对/绝对路径，但须配置autoload、version等字段，否则类无法加载。
path 类型怎么配才能让 Composer 找到本地模块
必须确保 composer.json 里 repositories 的 path 值指向一个**包含合法 composer.json 的目录**，且该文件中 name 字段要和你 require 的包名完全一致。
常见错误现象：Could not find package xxx/yyy at any version 或安装后代码不生效——大概率是路径没对上，或本地模块的 name 和 require 写的不一致。
-
path值支持相对路径（如../my-package）和绝对路径（如/Users/me/projects/my-package），但不能带通配符或~ - 本地模块目录下必须有
composer.json，且至少含name、version（可写"dev-main"）、autoload（否则类不会被自动加载） - 运行
composer update xxx/yyy比全量update更安全，避免误更新其他依赖
为什么 require 后 vendor 里没生成软链接而是复制了一份
Composer 默认行为就是**复制内容**，不是挂载；它不提供类似 npm 的 link 式实时联动。所谓“path 加载”，只是让 Composer 把本地目录当源去读取元信息并拷进 vendor，改本地代码不会自动反映到项目里。
这直接导致：你在本地模块改了类，主项目不重新 composer update 就看不到效果——很多人卡在这以为配置失败。
- 想实时调试？得配合
autoload-dev+composer dump-autoload -o，或者把本地模块的src/目录直接加到主项目的autoload.paths里（仅开发阶段） - 如果本地模块用了
psr-4，确认其autoload中的命名空间前缀和实际目录结构严格匹配，否则dump-autoload后仍找不到类 - Windows 下路径分隔符不用特别处理，Composer 内部已兼容，但双反斜杠
\在 JSON 里需转义为\\
多个 path 模块互相依赖时怎么避免版本冲突
当 A 模块 require B 模块，而两者都是 path 类型，Composer 会尝试解析依赖树，但**不校验 path 模块之间的版本约束是否满足**——它只看 composer.json 里写的 version 字段，且默认用 dev-main 这种占位符。
结果就是：A 要求 B >=1.2，但 B 的 composer.json 写着 "version": "dev-main"，Composer 认为满足，实际可能根本没实现 1.2 的接口。
- 所有 path 模块的
version字段建议统一用"dev-master"或"dev-main"，避免数字版本引发语义误解 - 如果 A 和 B 都在本地开发，且存在强耦合，不如暂时把 B 的代码直接
require到 A 的autoload.paths，绕过 Composer 依赖解析 - CI 环境务必禁用
path类型（通过composer install --no-plugins或移除repositories），否则打包会出错
vendor/autoload.php 加载不到 path 模块的类
最常漏掉的是 autoload 配置本身——path 模块的 composer.json 如果没声明 autoload，就算文件放对了、require 对了，类也进不了自动加载器。
另一个隐蔽问题是：主项目和 path 模块用了不同 PSR-4 前缀，但目录结构没对齐，比如模块声明 "MyLib\": "src/"，实际类文件却放在 src/Utils/Helper.php，而命名空间是 AppUtils，这就断了映射链。
- 检查方式：运行
composer show xxx/yyy，看输出里autoload字段是否显示正常；再执行composer dump-autoload -v，观察有没有 warning 提示路径不存在 - path 模块的
autoload必须是完整声明，不能省略psr-4键，也不能把""当根命名空间来用（PHP 不允许空命名空间自动加载） - 如果模块含
classmap，记得每次增删类文件后手动跑一次composer dump-autoload，它不会自动扫描
path 类型本质是“骗” Composer 把本地目录当远程包用，所有约束检查都退化为字符串匹配。真正解耦靠的不是路径配置多漂亮，而是每个模块能否独立 composer install 并跑通测试——这点很容易被跳过。
