在 composer.json 中配置 path 类型仓库需添加 repositories 字段，设 type 为 “path” 并指定含有效 composer.json 的本地路径（推荐相对路径），require 时必须用 “dev-分支名” 或 “*@dev”，Composer 会软链接而非复制代码，前提是系统支持 symlink 且分支别名一致。
composer.json 里怎么写 path 类型的 repository
直接在项目根目录的 composer.json 中添加 repositories 字段，类型设为 path，指向本地文件夹。这个路径可以是相对路径（推荐），也可以是绝对路径，但必须包含有效的 composer.json 文件。
- 相对路径示例：
"../my-package"表示上一级目录下的my-package文件夹 - 路径内必须有可解析的
composer.json，且其中需定义name和version（或使用dev-main等分支别名） -
packagist.org默认会被禁用，除非显式保留；若只想临时覆盖某个包，建议用packagist类型 +allow-plugins配合path，避免全局影响
require 时版本号必须写成 “dev-分支名” 或 “*@dev”
Composer 对 path 类型仓库不支持语义化版本匹配（如 ^1.0），它只认开发分支别名。如果你的本地包 composer.json 中 "version": "dev-main"，那 require 里就得写 "dev-main"；如果没写 version，默认 fallback 到 dev-master（旧版）或 dev-main（git 2.28+ 默认主分支）。
- 错误写法：
"my-vendor/my-package": "^1.2"→ 安装失败，提示“could not find package” - 正确写法：
"my-vendor/my-package": "dev-main"或"my-vendor/my-package": "*@dev" - 运行
composer update my-vendor/my-package后，Composer 会软链接（symlink）该目录，而非复制代码
为什么 vendor 里是 symlink 而不是 copy？如何确认是否生效
Composer 默认对 path 仓库启用 symlink 模式，这是为了实时反映本地修改。但前提是：你的系统支持符号链接（linux/macOS 默认支持；windows 需管理员权限开启 Developer Mode，否则 fallback 为 copy）。
- 检查方式：进入
vendor/my-vendor/my-package，执行ls -la（macOS/Linux）或dir（Windows），看到箭头指向源路径即为 symlink - Windows 下若看到完整复制的文件，说明 symlink 失败，可临时加配置：
{"config": {"preferred-install": {"my-vendor/my-package": "source"}}，再
composer update - 改完本地包代码后，无需重新
composer update，直接运行项目即可生效（laravel 等框架可能需清 config/cache）
多个本地包依赖时的常见冲突和绕过方式
当两个本地包都 require 同一个第三方包的不同版本，或互相 require，容易触发循环依赖或版本不可满足错误。Composer 不会自动解析本地路径间的依赖图，它只按 require 字段硬解析。
- 最稳妥做法：所有本地包先用
composer install独立安装依赖，确保各自vendor可运行；再统一接入主项目 - 避免在本地包的
composer.json中写死高版本约束（如"php": ">=8.2"），主项目 php 版本低时直接中断 - 临时调试可用
composer require --dev --no-update先写入，再手动编辑composer.json调整版本别名，最后composer update --with-all-dependencies
实际开发中，path 仓库最易被忽略的是 symlink 权限和分支别名一致性——改了 Git 分支名却忘了同步 composer.json 里的 version，或者在 Windows 上没开 Developer Mode，结果改半天代码都不生效。