Composer path仓库是将本地目录作为包源，跳过网络拉取直接软链接或复制代码到vendor，适用于未发布、需联调调试或离线开发的场景。
什么是 Composer path 仓库，它适合什么场景
Composer 的 path 仓库类型，本质是让 Composer 把本地某个文件夹当作一个“已发布”的包来安装，跳过 Packagist 和网络拉取。它不走版本约束解析，而是直接软链接（或复制）源码到 vendor/，因此特别适合：
- 正在开发中、还没
git tag或没 push 到 Packagist 的包 - 需要边改边测、反复调试接口或行为的场景
- 多个本地包之间存在依赖，想避免每次
composer update都触发构建
注意：path 仓库默认启用 symlink（Linux/macOS）或 copy（Windows），但 symlink 更快也更贴近真实开发流——改源码立刻生效，不用重装。
配置 path 仓库的最小必要步骤
要在项目中使用本地包，只需两步：
- 在项目根目录的
composer.json中添加repositories块，指定路径 - 运行
composer require或composer update安装该包
例如，本地有一个未发布的包位于 ../my-awesome-package，其 composer.json 已定义 "name": "acme/my-awesome-package"：
{
"repositories": [
{
"type": "path",
"url": "../my-awesome-package"
}
],
"require": {
"acme/my-awesome-package": "*"
}
}
关键点：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
url必须是相对或绝对路径，且指向包含有效composer.json的目录 - 版本约束写
"*"最稳妥；若写具体版本（如"dev-main"），则要求包内composer.json的"version"字段或 Git 分支名匹配 - 不要漏掉
repositories的数组结构，单个仓库也要用[{...}]
常见错误：为什么 composer install 后 vendor 里没链接，或者报错 “Could not find package”
这类问题几乎都源于路径或命名不一致：
-
url路径拼错，比如少了个..，或 Windows 下用了反斜杠\（应统一用正斜杠/） - 本地包的
composer.json缺少"name"字段，或名字和require中写的不完全一致（大小写、连字符、vendor 名都敏感） - 本地包目录下没有 Git 仓库（
.git文件夹），而你用了dev-main这类分支别名——Composer 会尝试读 Git 元数据，没 Git 就 fallback 失败 - 项目已缓存旧的包信息，执行
composer clear-cache再试
另外，如果看到 Package acme/my-awesome-package is not installed 却又在 vendor/ 里有文件，大概率是之前用的是 dist 模式安装，现在切到 path 后没清理干净，建议删掉 vendor/acme/my-awesome-package 和 composer.lock，再 composer install。
调试时怎么确保改代码立刻生效
path 仓库启用 symlink 后，vendor/acme/my-awesome-package 实际是符号链接，指向你的源码目录。所以：
- 直接编辑
../my-awesome-package/src/...文件，运行项目就能看到效果 - 不需要
composer update，也不需要重启 PHP-FPM 或 Swoole 进程（除非涉及 opcache） - 若发现修改不生效，先检查是否真被 symlink：运行
ls -la vendor/acme/my-awesome-package，输出应类似my-awesome-package -> ../../my-awesome-package - Windows 用户若看到复制而非链接，可在
composer.json的config下加"preferred-install": {"acme/my-awesome-package": "source"}强制源码模式（但 symlink 在 Win10+ 开发者模式下也可用）
最易忽略的一点：有些 IDE（如 PhpStorm）默认不跟随 symlink 跳转，需在设置里开启 “Follow symbolic links”。否则 Ctrl+Click 会跳到 vendor 里的副本，而不是你正在改的源码。
