用 path 类型仓库可让 Composer 直接加载本地项目作为包，关键需配置 repositories 并确保本地包 composer.json 的 name 与主项目 require 一致、不设 type=project；url 须为相对路径，且需检查 repositories 位置、本地包 version 字段及 require 版本约束是否匹配。
用 path 类型仓库让 Composer 加载本地项目
直接把本地项目当 Composer 包用，不用反复 composer install 或手动 symlink，关键在正确配置 repositories 和包名匹配。
必须满足两个前提：本地项目根目录下有合法的 composer.json，且其中 "name" 字段（如 "myorg/my-package"）和你主项目 require 里写的完全一致；同时该 composer.json 中不能设 "type": "project"（否则 Composer 会跳过它）。
- 在主项目的
composer.json的repositories数组里加一项：
{
"repositories": [
{
"type": "path",
"url": "../my-package"
}
]
}
url 是相对于主项目 composer.json 的路径，支持 ../、./packages/xxx 等写法，但不支持绝对路径（Windows 下 C:/xxx 会失败）。
为什么 composer require 不生效？检查这三处
常见现象是执行 composer require myorg/my-package 后报错“Could not find package”，或装了却没走本地路径——基本都是配置断点在这三处：
-
repositories没放在主项目composer.json的最外层（不能嵌套在config或extra里） - 本地包的
composer.json缺少"version"字段，或设成了"dev-main"以外的值（Composer 会拒绝解析非稳定版本，除非你显式加@dev） - 主项目
require中的版本约束写死了，比如"^1.2"，而本地包"version"是"dev-main"，两者不匹配
最省事的做法：本地包 composer.json 中删掉 "version" 字段，然后 require 时指定 "dev-main"：
"require": {
"myorg/my-package": "dev-main"
}
path 仓库的自动软链接行为与注意事项
Composer 在安装时会为 path 类型依赖创建符号链接（Linux/macOS）或复制（Windows），而不是拷贝整个 vendor 目录。这意味着你改本地包代码，主项目立刻可见——适合调试。
- Linux/macOS 下，
vendor/myorg/my-package是指向../my-package的 symlink，ls -l可确认 - Windows 默认禁用 symlink（尤其非管理员权限），此时 Composer 会 fallback 到硬复制，导致修改本地包后需手动
composer update myorg/my-package - 如果本地包用了
autoload-dev，它的测试文件不会被主项目自动加载，要额外在主项目中补"autoload-dev"或用composer dump-autoload
开发中频繁切换本地/远程包怎么办？
上线前要切回 Packagist 正式版，但又不想手动改 composer.json ——推荐用 config.platform 配合环境变量临时覆盖：
先确保本地包已发布正式版（如 1.3.0），然后在主项目中：
- 开发时：保留
repositories+"dev-main"，正常调试 - 上线前：注释掉
repositories，把require改成"^1.3"，再composer update - 或者更轻量：用
COMPOSER_ROOT_VERSION=1.3.0 composer install强制锁定版本，避免临时改 JSON
真正容易被忽略的是：一旦启用了 path 仓库，Composer 就不再查询 Packagist，哪怕你只配了一个本地仓库——所以别在生产环境的 composer.json 里留着它。
