Composer 的 path 类型仓库是本地开发私有包最直接、最轻量的方式，通过配置 repositories 指向本地路径并设 "symlink": true 实现改即生效；需确保路径正确、name 匹配、权限正常。

Composer 的 path 类型仓库是本地开发私有包最直接、最轻量的方式——它让 Composer 把本地文件夹当作一个可安装的包源，无需每次改完代码都重新打包、推送、更新版本号，真正实现“改即生效”。

配置 path 仓库的基本结构

在项目根目录的 composer.json 中添加 repositories 配置，指向你本地包的路径：

{
  "repositories": [
    {
      "type": "path",
      "url": "../my-awesome-package"
    }
  ],
  "require": {
    "vendor/my-awesome-package": "*"
  }
}

注意两点：
- url 是相对于当前 composer.json 文件的路径，支持相对路径（推荐）或绝对路径；
- 包名（vendor/my-awesome-package）必须与被引用包自身 composer.json 中的 name 字段完全一致；
- 版本约束写 "*" 即可，Composer 会自动识别该路径下 composer.json 中的 version 或使用 dev-main（若为分支）。

启用 symlink 模式提升开发体验

默认情况下，Composer 会把本地包复制进 vendor/，改代码后需手动重新 install。开启 symlink 后，Composer 直接创建符号链接，编辑本地源码立刻反映到项目中：

• 在 repositories 条目中增加 "options": { "symlink": true }；
• 确保你的系统支持符号链接（Linux/macOS 默认支持，Windows 需启用开发者模式或以管理员运行终端）；
• 执行 composer update vendor/my-awesome-package 触发重链接（首次安装也生效）。

验证是否成功：进入 vendor/vendor/my-awesome-package，用 ls -la（macOS/Linux）或 dir（Windows）查看是否为链接而非普通文件夹。

配合 autoload-dev 和脚本快速调试

本地包常需独立测试，建议在它的 composer.json 中合理配置：

• "autoload-dev" 声明测试类路径，如 "tests/": "tests/"；
• "scripts" 加入一键命令，例如 "test": "phpunit"；
• 主项目中无需额外操作——因为 symlink 已让代码实时同步，直接在主项目里运行 vendor/bin/phpunit 或调用包内类即可验证修改效果。

小技巧：如果包里用了 __DIR__ 或文件路径相关逻辑，注意 symlink 不影响运行时路径解析，PHP 仍会按真实文件位置工作，无需特殊处理。

常见问题与绕过方式

遇到安装失败？先检查这几个点：

• 路径拼写错误（尤其 Windows 下反斜杠、大小写敏感）；
• 本地包缺少 composer.json，或其中 name 与主项目 require 不匹配；
• 权限问题导致无法创建 symlink（macOS/Linux 可试 sudo composer update 临时排查，但不推荐长期使用）；
• 已存在同名包且被缓存，运行 composer clear-cache 再重试。

不想全局启用 symlink？可以只对某个包启用："options": { "symlink": true } 放在对应 repository 下，不影响其他仓库。