path仓库仅适用于单机开发，因其依赖本地文件路径，跨机器时路径失效、权限错误或大小写问题频发，且无版本管理；应通过私有Packagist、Git VCS或Satis等版本化方案实现安全共享。
不能直接靠 path 仓库实现跨项目“共享”——它只是本地开发时的临时绕行方案，提交到 Git 就等于给团队埋雷。
为什么 path 仓库只适合单机开发
path 仓库本质是让 Composer 跳过网络，直接读取本地文件系统路径（比如 ../../packages/utils）。但这个路径在别人机器上大概率不存在，或指向错误分支、权限不足、甚至目录名大小写不一致（尤其 Windows/macOS 混用时）。常见错误现象：Could not find package myorg/utils 或 Source directory ... does not exist。
它不解决协作问题，只解决“我改完 utils，想立刻在 app 里试效果”这一个场景。所以：
- 永远不要把
repositories中 type: "path" 的配置提交进composer.json - 不要在 CI/CD 流程中使用 path 仓库——构建机根本没那个目录
- 不要指望它能替代版本管理：没有 tag、没有语义化版本、无法回滚
怎么安全地本地验证 path 仓库
你可以在自己机器上快速启用 path 仓库，又不污染项目配置。关键命令是 composer config，它会把配置写入全局 ~/.composer/config.json，不进 Git：
composer config repositories.local path "../../packages/utils"
执行后，composer install 就能识别该路径下的包。要关闭？删掉这行配置即可：
composer config --unset repositories.local
注意点：
- 路径必须是绝对路径，或相对于当前项目根目录的相对路径（推荐后者）
- 目标目录下必须有合法的
composer.json，且name字段格式为vendor/name（如myorg/utils） - 如果包用了
psr-4自动加载，确保autoload映射正确，否则class not found
真正能跨项目的共享方案是什么
生产级跨项目共享，必须走版本化、可寻址、可审计的路径。三种主流做法按推荐度排序：
-
私有 Packagist（如 Private Packagist、JFrog Artifactory）：最接近 packagist.org 的体验，支持 SSO、审计日志、依赖代理，
repositories类型为composer，URL 填https://pkgs.internal.example.com/packages.json -
Git 仓库直连（VCS）：把共享包放公司 GitLab/Gitee 企业版，
repositories类型设为vcs，URL 填 Git 地址；Composer 会 clone 并按 tag 解析版本 -
Satis 静态镜像：适合离线环境或轻量团队，用
satis.json定义要索引的 Git 仓库，生成静态packages.json和 dist zip 包，repositories同样是composer类型
所有这些方案都要求你在共享包仓库里打 Git tag（如 v1.2.0），并在主项目中 require 时指定版本约束（如 "myorg/utils": "^1.2"）。
符号链接（symlink）不是共享，只是开发便利性开关
path 仓库默认启用 symlink，意味着修改 ../../packages/utils/src/Helper.php，主项目立刻生效——但这只发生在你本地。CI 构建、测试服务器、其他同事的机器上，要么失败，要么 fallback 到复制模式（mirror），行为不一致。
如果你真需要实时联动，唯一可控的方式是：
- 确认所有开发者都启用 symlink：
composer config --global store-auths false不影响，关键是composer install时未被禁用 - 避免在
vendor/外部硬编码路径，所有类通过 autoloader 加载 - CI 环境必须禁用 symlink（加
--no-symlinks），并确保 Git 能正确检出子模块或依赖包
最容易被忽略的一点：path 仓库和 symlink 都无法解决 autoload 冲突。如果两个项目 require 同一个包的不同 major 版本，而它们又共用同一份源码（比如都 link 到同一个 utils 目录），运行时 class 重定义错误几乎必然发生——Composer 的 autoloader 是按项目隔离的，但 symlink 让物理文件变成了共享态，这是设计之外的状态。
