能调试，但必须绕过 Composer 自身安装流程；因 Xdebug 仅对 CLI 入口生效，本地包代码在后续 require 阶段载入时调试已关闭，且 symlink 路径不一致、autoload 优化或 IDE pathMappings 错配均导致断点失效。
能调试，但必须绕过 Composer 自身安装流程，否则 Xdebug 断点进不去、类找不到、改了代码不生效——核心矛盾不在“能不能”，而在“怎么让 PHP 真正加载你正在编辑的那堆文件”。
为什么 composer install 后断点不触发
Composer 安装过程本身是 CLI 脚本执行，Xdebug 默认只对入口（composer.phar）生效；而你的本地包代码（如 src/Helper.php）是在后续 require 阶段才载入，此时 Xdebug 的自动启动早已结束。更隐蔽的问题是：
- IDE 的 path mapping 指向了
vendor/vendor/name下的 symlink 目标，但实际断点设在你编辑的../my-package目录，路径不一致 → 断点失效 - 用了
composer dump-autoload -o，类被写进vendor/composer/autoload_classmap.php，执行的是静态映射，IDE 无法关联源码 - 没关掉 Composer 自带的 autoloader 优化，导致即使改了本地包，PHP 还是从 classmap 里找旧类
repositories + path 配置必须满足的硬条件
漏一个，composer update vendor/name 就静默跳过，连报错都不给。关键五点：
-
repositories必须写在主项目composer.json根级，不能塞进require或config里 -
url是相对于主项目composer.json的路径，例如"../my-package"，末尾不能加/，也不能用file://或绝对路径 - 本地包目录下必须有合法
composer.json，且name字段和require中写的**逐字节一致**（"acme/utils"≠"Acme/Utils"） - 本地包自己的
composer.json里要显式加"options": {"symlink": true}，否则 Windows/Linux 都可能 fallback 到 copy - 本地包目录必须已初始化 Git（哪怕只是
git init && git add . && git commit -m "init"），否则 Composer 推不出分支名，dev-main会匹配失败
改了本地包代码，vendor 里为啥没变
因为 Composer 对 path 类型仓库的处理不是实时监听，而是单次映射。改完代码后必须手动触发重载：
- 运行
composer update vendor/name（推荐，只更新指定包，不扰动其他依赖） - 不要删整个
vendor/再install—— 这会让本地包变成普通副本，失去“改即生效”的意义 - 验证是否真用了 symlink：
ls -la vendor/vendor/name（Linux/macOS）或dir vendor endor ame（Windows），看到箭头或JUNCTION才算成功 - 如果显示为普通文件夹，说明 fallback 成了 copy，立刻检查本地包
composer.json是否漏了options段
类找不到？别急着重装，先查 autoload 映射
包存在 ≠ 类能 new，autoload 才是执行层的最后关卡。常见断点：
- 本地包
composer.json的autoload或autoload-dev没配对：比如"psr-4": {"MyPackage\": "src/"}，但你use MyPackageHelper，而文件实际在src/Helper.php—— 这没问题；但如果命名空间写成MyPackageHelper，而 autoload 写的是"MyPackage": "src/"（缺反斜杠），就挂了 - 改了
autoload-dev后没运行composer dump-autoload --dev，vendor/composer/autoload_dev.php没更新 - 测试类在
tests/下，但autoload-dev.files没包含tests/bootstrap.php，导致 PHPUnit 启动时就报错 - 验证方式：直接执行
php -r "echo class_exists('MyPackageHelper') ? 'ok' : 'fail';"，输出ok才说明 autoload 生效
最易被忽略的一点：Windows 用户必须以管理员身份运行终端才能创建 symlink；Docker 场景下需加 --cap-add=SYS_ADMIN 并确认挂载方式支持 symlink，否则所有配置都白搭。
