不能直接在 composer.json 里写 path 仓库提交到 git，因为 path 依赖本地文件系统路径，团队成员目录结构不一致会导致 ci 构建失败、路径不存在或权限错误，且 file:// 协议不适用、绝对路径格式复杂易错；安全做法是用 composer config --global 配置本地 path 仓库，各成员独立设置，不提交至 git。
为什么不能直接在 composer.json 里写 path 仓库提交到 Git
因为 path 仓库依赖本地文件系统路径，而不同团队成员的目录结构几乎不可能一致。比如你写 "url": "../packages/utils"，别人机器上这个相对路径可能指向空目录、权限错误，甚至根本不存在——CI 构建机更是一运行就报 Could not find package 或 Source directory does not exist。
它不是协作方案，只是你个人开发时的临时绕行手段。硬塞进项目 composer.json 并提交，等于给所有人埋雷。
- 绝对路径在 Windows 上必须用
C:/Users/xxx格式（正斜杠），反斜杠会被 JSON 解析为转义 - 路径含空格或中文时，容易触发解析失败，尤其在 CI 环境中
-
file://协议不适用于path类型；它只对vcs类型有效，且必须是绝对路径
怎么安全地让多个团队共用同一个本地包（仅限开发阶段）
用 composer config 把 path 仓库写进全局配置，不进 Git，也不影响 CI：
- 在自己机器上执行：
composer config --global repositories.local path "../../packages/utils" - 确保
../../packages/utils下有合法composer.json，且"name"字段完全匹配 require 的包名（如"acme/utils"） - require 时显式写分支别名：
composer require acme/utils:dev-main（不能只写*，否则可能找不到） - 要关闭？执行：
composer config --global --unset repositories.local
这样所有团队成员各自配置一次，就能共享同一套本地包路径约定，又不会互相干扰。
require 了却没装进 vendor？先查这三个地方
最常见不是命令错，而是匹配断在了底层规则上：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json中repositories必须是数组，且"type": "path"不能漏写 - 本地包的
composer.json必须有"name"，且大小写、斜杠、vendor 名与require中一模一样（acme/utils≠acme/utils-dev） - 版本约束必须能命中：如果本地包没写
"version"字段，就只能用dev-main这类分支名；若写了"version": "1.0.0"，则require写"^1.0"才生效
验证是否识别成功：composer show acme/utils。没输出，说明 name 或版本根本没对上。
真正跨团队共享，必须放弃 path，转向版本化源
path 仓库没有版本、没有审计、不能回滚，也不支持权限控制。一旦进入联调或预发，它立刻失效。
生产级共享只有三条路可走，且都要求把包托管在团队可访问的统一位置：
- Git 直连（VCS）：在
composer.json中配"type": "vcs"，URL 填公司 GitLab 地址（如https://git.internal/acme/utils.git），require 时写acme/utils:dev-main - 私有 Packagist（如 Private Packagist、Artifactory）：配
"type": "composer"，URL 填https://pkgs.internal/packages.json，体验最接近 packagist.org - Satis 静态镜像：适合离线环境，用
satis.json定义要索引的 Git 仓库，生成静态packages.json，同样走composer类型源
关键点在于：所有这些方案都依赖一个可寻址、可版本化、可审计的远程端点。本地路径不是终点，只是通往那个端点前的调试跳板。
