在 composer.json 中配置 path 仓库需设 "type": "path"，"url" 为绝对或相对路径（如 "../my-package"），目标目录须含合法 composer.json（含匹配的 name 和兼容 version）；勿提交至生产环境或 Git。
怎么在 composer.json 里正确配置 path 仓库
path 仓库不是插件，也不是远程包，它只是让 composer install 或 composer update 时，把本地某个目录当成一个“源”来加载包。关键在于路径必须是**绝对路径**或相对于 composer.json 的**相对路径**，且该路径下必须有合法的 composer.json（含 name 和 version）。
常见错误：写成 "url": "../my-package" 却没加 "type": "path"；或路径指向空目录、缺少 composer.json，结果报错 Could not find package xxx at version *。
- 必须显式声明仓库类型：
"type": "path" - 路径支持通配符，比如
"url": "../../packages/*"，但注意：只有子目录里有合法composer.json才会被识别 - 如果路径含空格或特殊字符，Windows 下容易出问题，建议用短路径或符号链接规避
- 不要在生产环境
composer.json中保留 path 仓库——CI 构建会失败，因为路径不存在
require 时为什么总是找不到本地包
根本原因通常不是配置错，而是 name 不匹配。Composer 查找包，靠的是 require 里写的包名（如 "acme/utils": "^1.0"）和 path 仓库中目标目录下 composer.json 的 "name" 字段是否完全一致（包括大小写和 vendor 名）。
典型现象：composer update 没报错，但包没装进 vendor/；或者提示 Package acme/utils is not available in the configured repositories。
- 检查目标目录的
composer.json是否有"name": "acme/utils"，不能是"acme/utils-dev"或漏写acme/ - 版本号要能匹配：如果 require 写
"^1.0"，本地包的"version"得是"1.0.0"或"1.2.3"，不能是"dev-main"（除非你显式 require"dev-main"） - 运行
composer show acme/utils看是否识别到——如果没输出，说明 name 或版本根本没对上
团队协作时 path 仓库怎么避免互相覆盖
path 仓库本质是“绕过网络直连本地文件”，所以它天然不协同。A 同学配了 ../../packages/log，B 同学机器上这个路径可能根本不存在，或者指向另一个分支的代码。直接提交带 path 仓库的 composer.json 到 git，等于埋雷。
可行做法是：用 composer config 命令在本地临时添加仓库，不进 git；或用 platform-check 类工具做路径存在性校验。
- 推荐做法：git 中只保留标准 packagist 仓库，团队约定用
composer config repositories.local path "../../packages/*"本地添加（该配置写入~/.composer/config.json，不进项目） - 如果必须进项目，用
composer.json的config.platform模拟依赖，再配合脚本检查路径是否存在，而不是硬编码 url - 别把
vendor/提交进 git——path 包装进去后，它的文件是真实链接还是复制，取决于options.symlink设置，而 symlink 在 Windows 上默认不生效
path 仓库 vs 仓库镜像 vs git 仓库：什么情况该换方案
path 是最快的本地验证方式，但仅限开发阶段。一旦涉及 CI、多环境部署、版本语义化管理，它就撑不住了。
比如：你想让测试服务器也跑同一份未发布的代码，path 仓库立刻失效；又或者两个开发者同时改一个 path 包，没人 merge，没人 review，很快就不知道谁的版本在跑。
- 需要 CI 支持 → 改用私有 git 仓库 +
"type": "git"，配合dev-分支或dev-main版本约束 - 需要精细权限控制或审计 → 上 Satis / Packagist Private / Toran Proxy 这类私有仓库服务
- 只是临时调试某次提交 → 用
composer require vendor/name:dev-feature-branch#commit-hash更轻量，无需配仓库 - path 无法触发自动 autoload dump 更新，改了类名或命名空间后记得手动
composer dump-autoload
最常被忽略的一点：path 仓库里的包，autoload 配置不会自动重载——你改了它的 psr-4 映射，得手动 composer dump-autoload -o，否则新类根本加载不到。
