必须将repositories写在主项目composer.json根级，type为"path"，url用相对路径指向含合法composer.json的目录，且本地包name、version与require严格匹配，否则Composer静默跳过。
直接用 repositories + path 类型就能让本地包实时生效，不用发布、不用 push、改完保存立刻在主项目里跑起来。
怎么在 composer.json 里声明本地包路径
主项目的 composer.json 必须显式添加 repositories 配置，且顺序和匹配逻辑会影响结果：
-
repositories是数组，Composer 从左到右扫描，第一个匹配的仓库就用它 —— 所以把path类型放最前面，避免被 Packagist 覆盖 -
url值必须是相对于主项目根目录的**绝对路径或相对路径**，不能是 URL 或未解析的变量（比如./my-package可以，$HOME/my-package不行） - 本地包自身的
composer.json里name字段必须和主项目require中写的完全一致（包括大小写和 vendor 名）
示例配置：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package"
}
],
"require": {
"vendor/my-local-package": "*"
}
}
执行 install 后为什么没生成符号链接
常见原因是 Composer 没识别出这是可 symlink 的本地包，或者系统/权限限制导致 fallback 到复制模式：
- Windows 默认不支持符号链接（除非以管理员身份运行 CMD/PowerShell，且启用了开发者模式），此时 Composer 会退而求其次，把包内容整个复制进
vendor/—— 这意味着你改本地包代码，主项目不会感知 - macOS/Linux 上如果
url路径指向的是挂载卷（如 Docker volume、NAS）、FUSE 文件系统，也可能无法创建 symlink - 确认是否启用 symlink：运行
composer config --list | grep use-symlinks，输出应为true；若不是，执行composer config -g use-symlinks true
本地包修改后主项目不自动重载类
这不是 Composer 的问题，而是自动加载缓存没更新。PSR-4 映射由 Composer 生成的 autoload 文件控制，但不会监听文件变化：
- 每次改了本地包的类名、命名空间或
src/结构，都得在主项目中运行composer dump-autoload - 如果本地包自身也定义了
autoload，它的映射只对自身生效；主项目加载它时，走的是主项目生成的 autoload 文件，所以必须重新 dump - 开发期建议加
--optimize参数：composer dump-autoload --optimize，否则 PSR-4 查找开销略高
多人协作时怎么避免路径配置冲突
path 仓库本质是本地路径硬编码，直接提交到 git 会导致其他成员路径失效：
- 不要把
repositories配置长期留在主项目的composer.json中 —— 它适合临时调试，不适合长期协作 - 推荐做法：把
path配置放在composer.json同级的composer.local.json（需配合插件hirak/prestissimo或自定义脚本），或使用环境变量 + 自定义安装脚本动态注入 - 更稳妥的替代方案：用
git类型仓库 +dev-main分支引用，配合composer config --global repo.packagist.allow-unstable true，既保持可复现，又不依赖本地路径
真正容易被忽略的是 symlink 权限和 autoload 缓存这两层 —— 它们不报错，但会让“改了没反应”变成高频迷惑行为。
