在 composer.json 的 repositories 中配置 type 为 path 的仓库时，必须使用绝对路径或相对于 composer.json 的相对路径，且目标目录需含合法 composer.json；name 和 version 需与 require 完全一致；修改本地代码后需删 vendor 对应包再 install 或更新 version 触发重链接。
composer.json 里怎么配 path repository 才能立刻生效
直接改 composer.json 的 repositories 段，加一个 type path 的源，指向本地目录。关键不是加了就行，而是路径必须是**绝对路径或相对于 composer.json 的相对路径**，且该目录下必须有合法的 composer.json（哪怕只是空包）。
常见错误：用 ~/my-package 这种 shell 展开路径 —— Composer 不解析波浪号；或者路径写错导致报 Could not find package xxx at version yyy。
- 推荐写法：
"type": "path", "url": "../my-local-package"（相对路径，最稳） - 不要在
url里写file://前缀，会失效 - 本地包的
name和version必须和你项目require的完全一致（包括 dev-master、v1.2.3 等） - 加完后运行
composer update vendor/package-name，别全量 update，省时间也避免意外升级其他包
为什么改了本地代码 composer install 却没更新？
因为 Composer 默认把 path 类型仓库当成“硬链接”处理：只要本地包的 composer.json 里 version 没变，它就认为内容没变，跳过 symlink 重建。你改了 PHP 文件，但版本号没动，vendor 下的软链还指着老内容。
- 最快验证方式：进
vendor/vendor-name/package-name，看它是不是个软链接，目标是否指向你预期的本地目录 - 强制刷新链接：删掉
vendor/vendor-name/package-name，再跑composer install - 更省事的做法：在本地包的
composer.json里把version改成dev-main或加个-dev后缀，然后composer update - 注意：如果本地包用了
autoload的psr-4，确保其autoload配置和线上包一致，否则类找不到
path repository 和 fork + dev-master 的区别在哪
本质区别是控制粒度和同步成本。path 是实时文件系统级映射，改保存即生效（只要重装/更新），适合调试逻辑、打桩、快速验证；而 fork + dev-master 走 Git，每次改都要 commit、push、composer update，适合协作或需要版本追溯的场景。
-
path下无法用composer require vendor/name:dev-feature-branch切分支 —— 它压根不走 Git - CI/CD 环境通常禁用
path（因依赖本地路径），所以别把它提交到主分支的composer.json - 如果本地包本身又依赖其他包，它的
require不会自动合并进主项目 —— Composer 只解析顶层依赖，不会递归加载 path 包里的require - 性能上没差别，但
path省去了 Git clone 和 zip 解压步骤，install更快
遇到 “Package … is not installed” 或 autoload 错误怎么办
这两个错误八成是路径或命名对不上。Composer 查找 path 包时，先按 require 里的名字去所有 repositories 匹配，再校验版本，最后才建软链。中间任何一环断掉都会失败。
- 检查
composer show -p输出里有没有你的包名 —— 没有说明repositories配置未生效或名字拼错了 - 运行
composer diagnose，它会提示repositories是否语法合法、路径是否存在 - 如果 autoload 报错，进
vendor/autoload.php查看是否生成了对应 PSR-4 映射；没生成，大概率是本地包的composer.json里autoload字段格式不对（比如少了psr-4键，或 namespace 冒号写成斜杠） - Windows 下注意路径分隔符：用
/或\都可以，但别混用；反斜杠必须双写\\
最麻烦的其实是团队协作时有人忘了删 path 配置就提交了，结果别人 composer install 直接失败。建议把这类配置放在 composer.json 的 config 段用 platform 或环境变量隔离，或者干脆用 composer.json 的 extra 字段加个标记，靠脚本判断是否启用 —— 这些细节不写进配置，就永远没人知道它为什么突然不工作。
