Composer原生支持通过path类型repositories从本地目录加载包：需在项目根composer.json中配置"type": "path"的源，本地包含合法composer.json且name匹配，require时用"dev-main"等分支名，自动创建符号链接实现热更新。
怎么让 composer 读取本地目录里的包
直接改 composer.json 的 repositories，加一个 path 类型源。不是软链、不是全局 require、也不是手动复制——composer 原生支持从本地文件系统拉包，但必须满足路径可访问且含合法 composer.json。
常见错误现象：composer install 报错 Could not find package xxx at any version，或提示 Package xxx is not installed，本质是路径没被识别、composer.json 缺失、或版本约束不匹配。
-
repositories必须写在项目根目录的composer.json里（不是包自己的），类型设为"type": "path" - 路径值支持相对路径（如
"../my-local-package"）和绝对路径（如"/home/user/pkg"），但不能带~或环境变量 - 本地包目录下必须有有效的
composer.json，且其中name字段要和你require时写的完全一致（包括 vendor 名） - 若本地包未打 tag，
"version"字段建议设为"dev-main"或"dev-master"，并在项目中用"dev-main"require
require 本地包时版本号怎么写才不报错
不是写 "1.0.0"，也不是留空——path 源下的包，composer 默认只认 dev- 开头的开发分支名，比如 dev-main、dev-develop。它会忽略 version 字段，只按目录下实际 Git 分支或当前 HEAD 解析。
使用场景：你正在迭代一个私有组件，不想每次改完都 push tag + packagist 同步，只想立刻在主项目里验证改动。
- 本地包目录运行过
git init并至少有一个 commit（否则composer拒绝加载） - 项目
composer.json的require写成"vendor/name": "dev-main"，不是"*"或"^1.0" - 如果本地包用的是
main以外的默认分支（比如develop），就得同步改require为"dev-develop" - 执行
composer update vendor/name而非全量update，能避免意外刷新其他依赖
为什么 composer install 后本地包没进 vendor/ 目录
进了，只是以符号链接形式存在——这是 path 类型源的默认行为，目的是实时反映本地修改。如果你看到 vendor/vendor/name 是个快捷方式（macOS/Linux 下 ls -l 显示 ->），说明成功了；如果是个普通文件夹，反而可能配置失效或用了其他源。
性能影响：无额外下载开销，但每次 autoload 都走真实路径，和普通包无异；兼容性上，PHP 7.4+ 和 Composer 2.0+ 均稳定支持。
- Windows 用户注意：需启用开发者模式或管理员权限，否则符号链接创建失败，
composer会回退为拷贝（此时目录变大且不同步） - CI/CD 环境通常禁用符号链接，这时
path源会自动 fallback 到 copy 模式，行为不一致——上线前务必在目标环境验证 - 想强制 copy（比如部署时不允许 symlink），可在
config里加"preferred-install": {"vendor/name": "dist"}，但失去热更新能力
多个本地包互相依赖时怎么配不冲突
每个本地包单独配 repositories，不能共用一个路径条目。Composer 不会递归解析本地包内部的 repositories，所有依赖关系必须在主项目的 composer.json 中显式声明。
容易踩的坑：A 包 require 了 B 包，你只在 A 的 composer.json 里写了 B 的 path，但主项目没配——composer 安装时仍会去 Packagist 找 B，而不是用你本地的。
- 所有本地包的
repositories都得集中写在主项目的composer.json顶层repositories数组里 - 每个本地包的
require项也必须出现在主项目中，哪怕只是开发时临时需要 - 若 A 和 B 都依赖 C，且 C 也是本地包，C 的
path条目只需写一次，但require要在 A、B、主项目三处各自声明（Composer 不共享依赖图）
路径嵌套本身没问题，但别让本地包路径落在主项目 vendor/ 下面——composer 会跳过扫描，直接报找不到包。
