composer如何在本地开发时临时替换远程包为本地代码？（path repository即时生效）

在 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 字段加个标记，靠脚本判断是否启用 —— 这些细节不写进配置，就永远没人知道它为什么突然不工作。