path仓库配软链接是调试阶段事实标准，因其他方式存在版本锁定、断点失效、autoload不映射或改代码不生效等问题；composer require不支持直接路径，只认vendor/name包名，报错“Could not find package”主因是repositories未在根级声明或url路径/包名不匹配。
用 path 仓库配软链接是最直接、最可控的方式，不是“可选方案”，而是调试阶段的事实标准。其他方法要么绕不开版本锁定，要么断点进不去、autoload 不映射、改了代码不生效。
为什么 composer require 本地路径不工作？
Composer 不支持 composer require /path/to/local/package 这种写法——它只认包名（vendor/name）和版本约束，不解析文件路径。你看到的报错 Could not find package，90% 是因为没在主项目 composer.json 里声明 repositories，或者 url 指向错误。
-
url必须是相对于主项目composer.json的路径，例如"../my-package"，不能是~/my-package或/home/user/my-package - 目标目录下必须有合法的
composer.json，且name字段必须和require中写的**逐字一致**（大小写、短横线、vendor 名全对） - 删掉整个
vendor/后再composer install并不能修复配置错误；先确认repositories在根级、语法正确、无尾逗号
path 仓库生效后，为什么改代码没反应？
因为 symlink 没真正建立，或 fallback 到了 copy 模式。Linux/macOS 默认尝试 symlink，但 Windows 和 Docker 默认禁用，且失败时不报错，静默降级为复制一份到 vendor/ —— 你改的是本地源码，执行的是 vendor 里的旧副本。
- 验证是否真用了 symlink：
ls -la vendor/vendor/name（Unix）或dir vendor\vendor\name（Windows），看到箭头或JUNCTION才算成功 - 关键配置不在主项目，而在**本地包自己的
composer.json** 中加："options": {"symlink": true} - Windows 用户必须以管理员身份运行终端；Docker 需加
--cap-add=SYS_ADMIN并挂载时启用follow_symlinks - 改完本地包代码后，只需
composer update vendor/name，不要删vendor/重装
怎么让 Xdebug 断点停进本地包代码？
别指望 composer install 或 php artisan 自动带你进本地包——Xdebug 只对 CLI 入口文件生效，后续 require 加载的类不会继承调试上下文，尤其 symlink 路径和 IDE 映射不一致时，断点直接失效。
- 写一个最小脚本，比如
debug-local.php，手动require 'vendor/autoload.php'，然后实例化本地包类并调用方法 - 用带参数的 PHP 直接运行：
php -dxdebug.mode=debug -dxdebug.client_host=127.0.0.1 -dxdebug.client_port=9003 debug-local.php - IDE（如 PhpStorm）的
path mappings必须指向你**实际编辑的本地包目录**（如../my-package），而不是vendor/vendor/name下的 symlink 目标 - 如果用了
composer dump-autoload -o，类会被写进静态映射表，IDE 无法关联源码；调试期间禁用优化 autoload，只用composer dump-autoload
最容易被忽略的一点：本地包的 composer.json 里必须有 "autoload" 配置（如 psr-4），否则即使 symlink 成功，类也加载不了；而这个配置一旦写错，composer dump-autoload 也不会报错，只会默默跳过——得靠 composer show vendor/name 看输出里有没有 autoload: psr-4 这一行来确认。
