Composer 的 path 类型仓库允许从本地目录加载依赖，需在 composer.json 的 repositories 中配置 type 为 path 并指定 url 路径，本地包须含合法 composer.json（含 name 和 autoload），require 中以 "@dev" 引用，安装时自动软链接或复制。

在 composer.json 中加载本地目录作为依赖，用的是 Composer 的 path 类型仓库（repository）。它不走 Packagist，而是直接从你本机的文件路径读取一个符合 PSR-4/Autoload 规范的包，适合本地开发、调试私有包或尚未发布到 Packagist 的项目。

配置 path 仓库

在项目的 composer.json 根对象中添加 repositories 字段，指定类型为 path，并给出本地目录的相对或绝对路径：

"repositories": [
  {
    "type": "path",
    "url": "../my-local-package"
  }
]

注意：url 是相对于当前 composer.json 文件的位置；支持 ../、./，也支持绝对路径（如 /Users/me/packages/my-pkg），但后者会降低项目可移植性，一般不推荐。

确保本地包有合法的 composer.json

被引用的本地目录（比如 ../my-local-package）必须包含一个有效的 composer.json，至少定义：

• name（格式为 vendor/name，如 acme/utils）
• autoload 或 autoload-dev（声明命名空间与路径映射）
• 可选但建议：设置 "minimum-stability": "dev" 和 "prefer-stable": true（避免意外拉取不稳定版本）

示例本地包的 composer.json 片段：

{
  "name": "acme/utils",
  "autoload": {
    "psr-4": { "Acme\\Utils\\": "src/" }
  }
}

在 require 中引用该包

像引入普通包一样，在 require 中写入你在本地包中定义的 name，版本号写 "*@dev"（强制使用最新开发版，因为 path 包没有版本标签，Composer 会自动识别为 dev-main 或 dev-master）：

"require": {
  "acme/utils": "@dev"
}

运行 composer update acme/utils 或 composer install 后，Composer 就会软链接（symlink）该目录到 vendor/acme/utils（Linux/macOS）或复制（Windows 默认，可通过 "options": {"symlink": true} 强制 symlink）。

小技巧与注意事项

• 修改本地包代码后，无需重新 composer update，直接生效（因为是链接或实时复制）
• 如果想始终用 symlink（包括 Windows），在 path 仓库里加 "options": {"symlink": true}
• 多个本地包？重复添加多个 path 仓库即可
• 不要把 path 仓库提交到生产环境 —— 它只适用于开发；上线前应替换为真实 Packagist 或私有仓库地址

基本上就这些。path 仓库不是黑魔法，只是让 Composer 把本地文件夹“假装”成一个可安装的包，关键在于路径对得上、composer.json 合法、require 名字一致。