Composer path仓库引入本地包需三者协同：正确配置repositories（绝对或相对路径、含合法composer.json）、显式启用symlink（在本地包composer.json中设"options":{"symlink":true}）、require版本匹配（如"dev-main"），缺一则vendor中为复制而非链接，改代码不生效。
Composer 用 path 类型仓库引入本地包，不是“装一个命令”就能链接，而是靠配置 + 约束 + 显式更新三者协同生效。配错任意一环，vendor 里出现的就是复制副本，改代码完全不生效——这问题极隐蔽，且报错信息往往不指向真实原因。
怎么写 repositories 才让 Composer 认出本地路径
关键不在 require，而在 repositories 字段本身是否被正确识别。Composer 只有先知道“这个目录是个包源”，才会去解析它。
-
url必须是相对路径（如../my-package）或绝对路径（如/Users/me/my-package），不能带file://前缀，也不能用~/ - Windows 下必须用正斜杠
/或双反斜杠\，单反斜杠会导致解析失败 - 路径必须指向一个**已存在**的目录，且该目录下必须有合法的
composer.json（无语法错误、无多余逗号、必须用双引号） - 推荐把
repositories放在composer.json根级，和require同级；顺序无关，但建议放最前
为什么 vendor 里是复制而不是 symlink
Composer 默认行为就是复制——这是为构建可重现性做的保守设计。所谓“软链接”必须显式启用，且只对 path 类型仓库生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 最稳妥方式：在**本地包自己的
composer.json** 中加"options": {"symlink": true}（注意：不是主项目的配置） - 替代方式：全局开启
composer config --global path.repo.symlink true，但会影响所有项目 -
composer install不触发 symlink 创建；必须执行composer update vendor/name或全量composer update - 验证是否成功：
ls -la vendor/vendor/name（macOS/Linux）输出中应含->指向你本地源码路径
require 写什么版本才匹配本地包
path 仓库不走语义化版本解析逻辑，它只做字符串比对。你 require 的版本必须和本地包 composer.json 里的 version 字段或分支名一致，否则直接报 Could not find package。
- 常见写法：
"dev-main"、"dev-master"、"*@dev"，前提是本地包有对应分支或设置了"minimum-stability": "dev" - 如果本地包没设
minimum-stability，主项目顶层就得加"minimum-stability": "dev"，否则dev-main会被忽略 - 不要写
"1.2.0"这类固定版本号，除非本地包composer.json的version字段明确写了它 - 本地包必须有 Git 仓库（哪怕空 commit）：Composer 会拒绝加载未初始化 Git 的目录，可临时
git init && git add . && git commit -m "init"
Windows 下 symlink 失败的典型表现和解法
Windows 默认禁止普通用户创建符号链接，所以即使配置全对，vendor 里也只会是硬拷贝，且无任何警告提示。
- 终端必须以**管理员身份运行**，否则
symlink: true彻底失效 - Win10/Win11 需打开「设置 > 更新与安全 > 面向开发人员 > 开发者模式」
- 验证是否启用成功：运行
dir vendor endor ame，若看到<SYMLINKD>表示链接建立；若只是普通文件夹，则仍是复制 - 路径含中文或空格？Composer 会静默跳过整个仓库，不报错也不提示——这是最容易被忽略的卡点
真正麻烦的不是配置本身，而是当 vendor 里看起来“有包”却始终不生效时，你得一层层确认：路径是否存在、name 是否大小写一致、Git 初始化了没、symlink 是谁配的、终端有没有管理员权限——少一个，就白调半天。
