path仓库比dev-main symlink更可靠，因其强制启用符号链接、跳过版本校验、直接映射本地路径，autoload规则正常生效且无需手动dump-autoload。
本地开发的 Composer 包，不用反复 composer install 或推 tag，直接用 path 仓库就能实时加载修改后的代码。
为什么 path 仓库比 dev-main symlink 更可靠
很多人试过在 require 里写 "my/package": "dev-main" 再配 repositories 的 package 类型，结果发现自动加载不生效、类找不到，或者改了源码要清缓存重装。根本原因是 Composer 默认对 package 类型仓库不做自动符号链接（symlink），而 path 类型会强制启用 symlink（只要文件系统支持），且跳过版本约束校验，直接映射到本地路径。
-
path类型下，Composer 把你的本地目录当“已安装包”看待，autoload规则照常走，vendor/autoload.php能正常加载 - 不需要手动
composer dump-autoload，改完源码立刻生效（除非用了 OPCache，需重启 PHP 进程） - 不依赖 Git 分支或 tag，连
.git目录都不需要存在
正确配置 path 仓库的三步操作
假设你在 /home/user/my-package 开发一个包，主项目在 /home/user/my-app，目标是让 my-app 加载修改中的 my-package。
- 在
my-app/composer.json的repositories里加一条："repositories": [ { "type": "path", "url": "../my-package" } ]注意：url是相对于composer.json文件的路径，不是相对于命令行当前目录 - 把包名和版本写进
require，版本必须是"*@dev"（不能是"dev-main"或"dev-master"）："require": { "my/package": "@dev" } - 执行
composer update my/package（不要用install，否则可能跳过 path 解析）
常见报错和绕过方法
运行 composer update 时提示 Could not find package my/package at version *@dev，基本是以下原因：
-
my-package/composer.json缺少"name"字段，或值与require中不一致（大小写敏感） -
url路径错误，Composer 找不到该目录（可用ls -l ../my-package验证） - 路径中含空格或中文——Linux/macOS 下部分 shell 会截断，建议用相对路径且避免特殊字符
- Windows 上用反斜杠
\——一律改用正斜杠/，Composer 内部统一处理 - 如果包里有
autoload-dev，但主项目没启用它，类不会被加载；确认composer dump-autoload --dev是否执行过
调试 path 是否生效的两个命令
别只看 vendor/ 有没有生成软链，关键看 Composer 内部怎么解析的：
-
composer show my/package输出里若出现source: path /home/user/my-package，说明path生效 -
composer config repositories可确认repositories配置是否被读取（有时因 JSON 格式错误被静默忽略） - 顺手删掉
vendor/my/package和composer.lock，再composer update，能排除缓存干扰
最易被忽略的是：改了 my-package 的 composer.json（比如加了新 autoload 规则），必须重新运行 composer update my/package，否则主项目的自动加载器不会更新映射关系。
