Composer引入本地库唯一可靠方式是配置path类型仓库，需在repositories字段正确定义相对或绝对路径，目录下有合法composer.json，并在本地包中设"options":{"symlink":true}启用符号链接。
Composer 引入本地库唯一可靠的方式是配置 path 类型仓库，不是改 require、不是手动 symlink、也不是靠 autoload 注入——配错任意一环，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字段明确写了它
改了本地包代码，为什么没立刻生效
符号链接本身是实时的，但自动加载映射（autoload）不会自动更新。改了命名空间、新增了类路径、调整了 psr-4 映射，都必须手动刷新。
- 改本地包的
composer.json（比如加了个新psr-4映射），必须在主项目运行composer dump-autoload - 改了类文件内容（如函数逻辑、新增方法），只要 symlink 正常，就立刻生效，无需任何命令
- 删掉
vendor/vendor/name再跑composer update vendor/name，可强制重建链接（适合怀疑软链损坏时） - CI/CD 环境下
path仓库默认失效，因为路径不存在；上线前必须切换回 Packagist 或私有仓库，否则构建失败
最容易被忽略的是：本地包目录必须是 Git 仓库（哪怕只有一次空提交），否则 Composer 会静默跳过整个仓库；还有就是 name 字段大小写和 vendor 名必须与 require 完全一致——差一个字母，就报 Could not find package，而错误信息根本不会提示是名字不匹配。
