不能直接共存，且强烈不建议混用；path仓库要求路径即时存在，而submodule默认未检出导致目录为空，引发composer报错，二者目标冲突——submodule按需加载，path强调即时可链接。
path仓库和git submodule能共存吗
不能直接共存，且强烈不建议混用。Composer的path仓库机制依赖本地文件系统路径存在且可读，而git submodule在克隆后默认是“未检出”状态（git submodule update --init才拉代码），此时composer install会立即报错：Could not find a matching version of package vendor/name——不是版本问题，是路径目录根本不存在。
常见误操作：把本地包放成子模块，再在主项目composer.json里配"type": "path"指向它。结果CI跑composer install失败，本地也得手动git submodule update才能继续，破坏了“开箱即用”的协作前提。
- 子模块本质是Git的引用管理工具，不提供运行时路径保障；path仓库则要求路径在
composer install执行瞬间就真实可用 - 两者目标冲突：submodule强调“按需加载”，path强调“即时可链接”
- 若真要复用同一份代码，应选其一：要么全用path（开发期）、要么全走vcs（发布/部署期）
想保留本地修改又不污染git repo，该怎么做
用studio工具替代手写repositories字段。它不修改composer.json，而是通过临时注入方式让Composer识别本地包，且支持自动禁用——比如在CI中设环境变量STUDIO_DISABLE=1，composer install就完全忽略本地路径，自动回退到远程源（如Packagist或私有vcs）。
安装后只需在项目根运行：studio add ../my-package，它会在~/.config/composer/studio.json（非项目内）记录映射，不提交、不冲突、不影响他人。
- 避免把
"type": "path"硬编码进composer.json并提交——这是最常被合并进main分支的配置污染源 - 不要用
git update-index --skip-worktree composer.json这类绕过Git的hack，后续composer require会覆盖掉你的跳过设置 -
studio生成的符号链接行为与原生path一致，改本地代码立刻生效，无需composer dump-autoload
生产部署时path仓库报错，怎么安全降级
Composer不会自动fallback到其他仓库，只要repositories里声明了path类型且路径不存在，就直接中断。唯一可靠解法是：构建前移除该仓库声明。
推荐在CI脚本中加一行：composer config --unset repositories.0（假设path是第一个仓库），或更稳妥地用jq精准删掉type: "path"项再写回composer.json。不要依赖--ignore-platform-reqs或--no-plugins，它们对路径校验无效。
- 切勿在
composer.json里写条件判断（如"url": "${LOCAL_PATH}"）——Composer不解析环境变量 - 如果用了
studio，默认已在生产环境失效，无需额外清理 - 检查
composer.lock是否含dist字段：若某包在lock里只有source（含type: "path"），说明上次composer update是在path有效时运行的，必须重新生成lock
为什么composer install --prefer-dist对path仓库没用
因为--prefer-dist只影响vcs或package类型仓库的下载策略，对path类型完全不生效。path的本质是文件系统链接，跟“dist还是source”无关。试图加这个参数只会让人误以为能绕过路径检查，实际仍会卡在目录不存在那一步。
真正有效的做法只有两个：删掉path配置，或确保路径存在且可读。后者在CI中意味着要提前cp -r或git clone对应包到指定位置，但这就失去了path的意义——不如直接配vcs。
-
path仓库没有dist概念，它的“分发”就是软链，不是zip包 - 所有试图用
--prefer-dist、--no-scripts、--no-autoloader绕过path校验的操作，都会失败 - 如果你发现某次
composer install没报错，大概率是因为之前composer update成功生成了lock，而lock里记的是包内容哈希，不是路径本身——但这不可靠，一旦lock更新就会暴露问题
