laravel本身不原生支持monorepo，但可通过composer path仓库+psr-4自动加载+本地symlink实现，关键在于根composer.json正确声明repositories、子包name与require严格一致、autoload映射精准且需手动dump-autoload。
Composer 本身不支持 Monorepo，但用 path 类型仓库 + 正确的 composer.json 结构 + 显式 autoload 配置，就能让 Laravel 或其他 PHP 应用正常加载本地子包——关键不是“能不能”，而是“怎么配才不踩坑”。
为什么 path 仓库在 Monorepo 里常报 Class not found
根本原因不是 Composer 不认路径，而是它只按 autoload 规则加载，不自动扫描子目录。哪怕你把包放进 packages/core 并配置了 repositories，如果主项目或包自己的 autoload 没映射对命名空间，Laravel 就找不到类。
-
packages/core/composer.json必须有"name": "acme/core"，且和主项目require中的包名完全一致 - 主项目
composer.json的autoload块不能只写根目录；若子包代码不在vendor/下被自动加载，就得手动加 PSR-4 映射："Acme\Core\": "packages/core/src/" - 运行
composer dump-autoload后检查vendor/autoload.php是否生成了对应映射，别依赖composer install自动搞定 - Laravel 的
AppServiceProvider或config/app.php不会自动发现新命名空间，类必须能被 Composer 自动加载器直接解析
path 仓库配置写错的三个典型现象
这些错误几乎占了 Monorepo 本地开发失败的 80%：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Could not find package acme/core at any version：根composer.json的repositories没声明，或路径写成../packages/core（相对路径起点是当前 composer.json 所在目录，不是命令执行目录） -
Package acme/core is not installed：本地包目录下没有composer.json，或缺少"type": "library"字段（非必需但强烈建议），或没运行过git init && git commit - vendor/acme/core 是普通文件夹而非符号链接：说明
path源未生效，Composer 回退到了 Packagist 或其他镜像源；检查是否误用了https://协议的 vcs 源覆盖了 path 配置
如何让 dev-main 版本约束真正生效
很多人写 "acme/core": "*" 或 "^1.0"，结果改了本地代码没反应——因为 path 类型仓库只响应 dev- 开头的版本约束，它忽略 version 字段，只看 Git 分支名。
- 本地包的默认分支是
main？那就 require"acme/core": "dev-main" - 分支叫
develop？require 得同步改成"dev-develop"，否则 Composer 会跳过 path 源去远程找 - 执行
composer update acme/core，不是composer update全量更新，避免意外刷新其他依赖 - 改完本地包代码后，不需要
composer update——符号链接已指向实时文件，但要composer dump-autoload刷新类映射
生产环境部署时 path 仓库怎么不炸
CI/CD 流水线一跑 composer install 就报错“Directory does not exist”，是因为生产机上根本不存在 packages/core 路径。这不是 bug，是 Composer 的明确性设计：它拒绝隐式 fallback。
- 绝对不要把
path配置提交到主干分支；开发时用composer config repositories.<name> --unset</name>临时移除，或用 Studio 工具管理本地覆盖 - CI 构建前执行
composer config --global repositories.<name> --unset</name>清掉全局配置，再跑composer install - 更稳妥的做法：在 CI 脚本中用
sed或jq删除repositories块，或维护两套composer.json（composer.prod.json+ 构建脚本重命名） - 所有
path包必须有对应的远程 Git 仓库，并在require中允许该远程源版本（如"dev-main as 1.0.0"），确保生产环境可降级拉取
Monorepo 的复杂点不在结构，而在边界——本地开发的便捷性和生产部署的确定性天然冲突。path 仓库只是个开关，开得不对，整个 autoload 链就断在第一环。最常被忽略的是：改了子包代码后，只清 vendor 不够，必须 dump-autoload；而上线前删掉 repositories，比修复一个报错的 CI 更省时间。
