答案是必须在主项目composer.json的repositories中显式声明type为path、url为相对路径（如"../my-pkg"）的仓库，且本地包目录须含合法composer.json；漏配symlink权限、autoload未执行dump-autoload或name不一致均会导致install静默失败或Class not found。
直接用 composer init 初始化主项目 + 手动加 repositories 配置，是最快能跑通本地包开发的方式；但若漏掉 symlink 权限、路径校验或 autoload 同步，composer install 会静默失败或类找不到。
怎么在主项目中声明本地包路径
必须在主项目的 composer.json 里写明 repositories，且类型为 path。Composer 不会自动扫描父目录或同级目录，路径必须显式指定、且相对于当前项目根目录。
-
url值填绝对路径会出错，只接受相对路径（如"../my-local-package"） - 路径末尾不加斜杠，
"../my-local-package/"可能被忽略 - 该路径下必须存在合法的
composer.json（含name字段），否则 Composer 直接跳过这个仓库 - 执行
composer install或composer update后，默认创建符号链接（symlink），不是复制文件
为什么本地包装进去了却 Class not found
常见原因不是路径没配对，而是 autoload 没同步生效。主项目和本地包各自的 autoload 是独立的，改了本地包的命名空间映射后，主项目不会自动感知。
- 确保本地包的
composer.json里有正确的autoload.psr-4，例如"MyPackage\": "src/" - 主项目运行
composer dump-autoload后，才能把本地包的自动加载规则合并进来 - 如果本地包代码实际在
lib/下，但autoload写的是"src/"，类就一定加载不到 - Windows 默认禁用 symlink，需以管理员身份运行终端，或提前执行
git config --global core.symlinks true
如何避免生产环境部署时报错
本地配置的 path 仓库在服务器上不存在，composer install 会直接中断，且不提示具体哪个仓库失效。
- 别把
repositories提交到 Git 主干分支；开发时可用.gitignore排除临时修改，或用composer config --unset repositories清理 - CI/CD 流程中，在安装依赖前先运行
composer config --unset repositories，再执行composer install --no-dev - 更稳妥的做法：用
studio工具管理本地包，它通过临时 patch 修改composer.json，不污染版本控制 - 所有本地包都应有对应的 Packagist/Git 远程源，确保
repositories移除后仍能正常安装
最容易被忽略的是：本地包的 name 必须和主项目 require 中写的完全一致（包括大小写和 vendor 名），Composer 不做模糊匹配；另外，type 字段建议明确写成 "library"，否则某些插件或脚本可能跳过处理。
