使用 path 仓库或直接内嵌方式可将本地包作为依赖引入。1. path 仓库通过在主项目 composer.json 中配置 repositories 指向本地目录，支持符号链接提升调试效率；2. 内嵌包则将本地库置于项目目录并通过 autoload 手动加载，适用于私有模块。建议开发阶段使用 path + symlink 方式便于共享，部署时切换为正式包避免路径依赖，确保本地包有完整 composer.json 并声明版本，团队协作需统一结构。
使用 path 仓库方式引用本地包
path 仓库是 Composer 推荐的本地依赖管理方式。它通过配置一个指向本地目录的路径，让 Composer 把该目录当作一个可安装的包。
操作步骤如下：
- 在主项目的 composer.json 中添加 repositories 配置，类型为 path
- 确保目标本地包有完整的 composer.json 文件
- 运行 composer require 安装依赖
示例配置：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package/"
}
],
"require": {
"vendor/my-local-package": "*"
}
}
注意：url 是相对于主项目根目录的路径。如果本地包版本发生变化，建议使用 "*" 或具体版本号配合 --prefer-source 安装。
额外提示：可在 url 后加 "options": {"symlink": true} 实现符号链接，方便实时修改调试。
{
"type": "path",
"url": "../my-local-package/",
"options": {
"symlink": true
}
}
启用 symlink 后，Composer 会创建软链而非复制文件，提升开发效率。
直接将本地目录作为包（非 path 仓库）
若不想配置 repositories，也可将本地包放在项目内（如 packages/ 目录），并通过 autoload 手动加载。
适用场景：小型工具库、私有组件、不打算发布到 Packagist 的模块。
步骤如下：
- 把本地包放入项目目录，例如 packages/my-utils
- 确保该目录下有 composer.json 并声明命名空间
- 在主项目的 autoload 中添加对它的自动加载
主项目 composer.json 示例：
{
"autoload": {
"psr-4": {
"MyUtils\": "packages/my-utils/src/"
}
}
}
这种方式无需 require 包，也不走 Composer 安装流程，仅用于代码加载。适合完全内部使用的模块。
注意事项与最佳实践
本地依赖主要用于开发环境，部署时应切换为正式版本或私有仓库。
- 确保本地包的 composer.json 包含正确的 name、type、autoload 等字段
- 团队协作时，建议用 path + symlink 方式，并统一路径结构
- 避免在生产环境中保留 path 仓库，可用脚本在部署时替换为 dist 包
- 使用 version 字段明确本地包版本，便于依赖解析
若本地包未声明版本，Composer 可能报错，可手动添加 "version": "dev-master" 临时解决。
基本上就这些。根据项目结构选择合适的方式，path 仓库更适合多项目共享本地库，而内嵌包更适合轻量级模块集成。
