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 名字一致。
