Composer link 命令仅本地生效，不写入配置和锁文件，团队无法共享；可靠方案是用 path 仓库：主项目 composer.json 中配置相对路径 repositories，本地包内设 "options": {"symlink": true}，并统一执行 composer update。
软链接本身无法同步，必须用 path 仓库 + 相对路径 + 显式提交配置才能让团队成员一致生效。
为什么直接 composer link 不适合团队协作
这个命令只在你本地 vendor/ 下建符号链接，不改 composer.json、不写入 composer.lock，也不影响其他人的环境。别人 composer install 时完全感知不到——他们装的还是 Packagist 上的正式版本，甚至可能因版本号冲突报错。
-
composer link是纯本地调试手段，本质是绕过 Composer 的依赖解析机制 - 它不触发 autoload 重生成，改了类名或命名空间后容易
Class not found - CI/CD 流水线里根本跑不通，因为没有目标目录或权限问题
团队可用的唯一可靠方式：用 path 类型仓库
这是 Composer 官方支持的、可提交到 Git 的方案，所有成员执行 composer install 或 composer update 后都会得到相同行为。
- 在主项目
composer.json的repositories数组里加一项："repositories": [ { "type": "path", "url": "../my-local-package" } ] -
url必须是相对路径（从主项目根目录算起），不能用~/或绝对路径；否则别人拉代码后路径失效 - 本地包目录下必须有合法的
composer.json，且其中name字段要和主项目require中写的完全一致 - 主项目
require中写"vendor/my-local-package": "dev-main"（分支名要匹配）
怎么让 path 仓库真正生成软链接而不是复制
默认情况下，path 仓库会把源码复制进 vendor/，这在开发中毫无意义。启用符号链接需满足两个条件：
- 在本地包自己的
composer.json里加："options": { "symlink": true } - 运行
composer update vendor/my-local-package（不是install）才会生效 - 确认是否成功：执行
ls -la vendor/vendor/my-local-package，输出应显示指向../my-local-package的箭头 - 注意：Composer 2.2+ 才支持
"symlink": true，老版本会静默忽略
团队配置容易被忽略的关键点
很多人配完发现别人机器上还是复制、或者报 Could not parse version constraint，往往卡在这几个地方：
- 本地包的
composer.json缺version字段或写法不规范（如"version": "dev-main"是允许的，但"version": "main"不行） - 主项目没删掉
composer.lock就直接update，导致旧记录残留；建议先rm composer.lock再composer update - 团队成员用了不同操作系统（Windows/macOS/Linux），符号链接权限或路径分隔符出问题；统一用 Unix 风格路径、避免空格和中文目录名
- CI 环境里没把本地包一起检出，导致
../my-local-package根本不存在——必须在 CI 脚本中提前git clone对应仓库并保持相对位置
真正落地时，最麻烦的从来不是配置本身，而是确保所有人的工作目录结构一模一样，以及每次变更都同步更新 composer.json 和 composer.lock。漏掉任意一个，就等于没配。
