答案是：path仓库本质是符号化路径映射，非自动挂载；调试失效主因是路径/包名不匹配、autoload未对齐或ide未配置源码映射。必须用绝对路径配置url，name严格一致，执行composer update触发解析，ide需手动映射vendor路径到本地源码目录。
Composer 的 path 仓库不是“本地包链接”，而是“符号化路径映射”，配置错就根本不会加载源码，调试时断点全失效。
为什么 path 仓库在调试时不起作用
常见现象是：改了本地包代码，composer install 后 vendor 里仍是旧文件；Xdebug 断点打在 vendor 下却跳不到你正在编辑的源码目录。根本原因是 Composer 并未真正“软链接”或“挂载”你的包，它只是按 path 配置去查找匹配的 composer.json，再根据其中的 autoload 规则生成自动加载逻辑——如果路径写错、包名不一致、或 autoload 没配对，就完全不生效。
-
repositories中的url必须是**绝对路径**（Windows 用C:/.../my-package，Linux/macOS 用/home/user/my-package），相对路径会被忽略 - 本地包的
name字段（如"myorg/utils"）必须和主项目require中声明的完全一致，包括大小写和斜杠方向 - 本地包的
autoload需显式覆盖主项目的自动加载缓存，建议用"psr-4": {"MyOrg\Utils\": "src/"}并确保命名空间与目录结构严格对应
composer.json 中 path 仓库的最小可行配置
不需要加 type: path（Composer 8.2+ 已默认识别），但必须把 repositories 放在根级，且优先级高于 packagist.org —— 否则即使本地有同名包，也会优先拉远程版本。
{
"repositories": [
{
"type": "path",
"url": "/Users/me/my-utils"
}
],
"require": {
"myorg/utils": "*"
}
}
- 执行
composer update myorg/utils才会触发 path 仓库解析；install不会重新检查路径有效性 - 若提示
Package myorg/utils not found，先运行composer validate确认本地包composer.json语法合法，再检查其name是否拼写一致 - 成功后
vendor/myorg/utils会变成一个指向源目录的符号链接（Linux/macOS）或 junction（Windows），不是复制
跨项目调试时 Xdebug 断点不命中怎么办
IDE（如 PHPStorm）默认只信任 vendor/ 下的路径，而 path 仓库实际加载的是你本地源码目录。必须手动告诉 IDE：“这个命名空间的代码，应该从这里找”。
- PHPStorm：进入
Settings > PHP > Servers，为当前项目配置路径映射，把vendor/myorg/utils映射到你的本地源码路径（如/Users/me/my-utils） - VS Code + PHP Debug：在
launch.json的pathMappings中添加"vendor/myorg/utils": "/Users/me/my-utils" - 别依赖
composer dump-autoload -o：优化后的 autoloader 会固化路径，改了path后必须先composer clear-cache再update
最常被忽略的一点：Composer 的 path 仓库机制本身不校验 PHP 版本兼容性或扩展依赖。如果你本地包用了 ext-gmp，但主项目没启用，调试时直接报 Class not found，错误堆栈却指向 vendor 目录——其实问题出在环境不一致，而不是路径配置失败。
