根本原因是path仓库使composer.lock记录不稳定路径导致Git误判冲突；应禁用dist写入、改用symlinks或环境隔离，确保lock仅存相对路径的source信息。
path仓库导致composer.lock频繁冲突的根本原因
Composer的path仓库（如"repositories": [{"type": "path", "url": "../my-package"}]）会让lock文件记录本地绝对路径或相对路径的dist信息，而不同开发者路径不一致、分支间软链接差异、甚至IDE自动重命名目录，都会让composer.lock中同一包的dist.url字段产生实质性差异——Git 会当成真实内容冲突，哪怕只是../foo vs ../../foo。
禁用path仓库的dist写入：强制走source模式
默认情况下，Composer对path仓库仍尝试生成dist快照（ZIP），但路径不稳定。必须显式关闭：
- 在项目根目录的
composer.json中添加："config": { "preferred-install": {"my-vendor/my-package": "source"}, "sort-packages": true } - 确保
my-vendor/my-package的composer.json里没有"dist"字段（它本就不该有） - 运行
composer update my-vendor/my-package --with-dependencies后，检查composer.lock中该包条目是否已移除dist块、仅保留source字段
用symlinks替代path仓库（更稳定）
当本地开发多个强耦合包时，path仓库不如符号链接可靠：
- 删掉
repositories里的path配置 - 在
vendor/my-vendor/下创建指向本地源码的软链：ln -sf /absolute/path/to/my-package my-vendor/my-package - 运行
composer dump-autoload即可加载，且composer.lock完全不记录路径信息——因为Composer把它当普通已安装包处理 - 注意：CI环境需改回
path或vcs仓库，并通过COMPOSER_MIRROR_PATH_REPOS=1环境变量启用镜像路径解析
CI与本地环境分离path行为
CI构建永远不该依赖path仓库，否则lock文件会混入开发机路径。必须做环境隔离：
- 在
.gitattributes中加：composer.lock merge=ours（主干优先） - CI脚本开头强制清理：
composer config --unset repositories，再按需添加vcs或packagist源 - 本地开发用
path，但提交前运行composer update --lock，确保lock中source.type为path、source.url是相对路径（如../my-package），而非绝对路径 - 绝对路径泄露通常源于
composer require时用了file://URL，应避免
真正难处理的不是冲突本身，而是path仓库让composer.lock同时承担“开发便利性”和“部署确定性”两个矛盾目标。只要lock里出现任何dist.url含file://或绝对路径，就已埋下团队协作雷区。
