Laravel 本身不原生支持 monorepo，但可通过 Composer path 仓库、PSR-4 自动加载及本地 symlink 或 --no-dev 控制依赖实现，关键在项目结构与 composer.json 配置。
直接说结论：Laravel 本身不原生支持 monorepo，但可以用 Composer 的 path 仓库 + 符合 PSR-4 的自动加载 + 本地 symlink 或 composer install --no-dev 控制依赖范围来实现，关键在项目结构设计和 composer.json 配置细节。
monorepo 是什么，为什么 Laravel 项目里要小心用
monorepo 不是 Composer 功能，而是代码组织策略——多个 Laravel 应用、共享包、CLI 工具等放在同一个 Git 仓库下，共用一套 CI/CD 和版本管理。问题在于：composer install 默认只处理当前目录的 composer.json，不会跨子目录自动发现包；Laravel 的 autoload 也不会递归扫描 vendor 外的源码。
- 常见错误现象：
Class not found，明明写了path仓库却没生效，或php artisan找不到自定义命令类 - 核心限制：Composer 的
path类型仓库必须显式声明在根composer.json的repositories里，且每个包需有独立name（如acme/core）和version（可用dev-main） - 别指望
composer update自动拉取子目录里的修改——它只按composer.lock锁定的 commit 或分支安装，改了本地代码得手动composer dump-autoload或删掉vendor重装
如何配置 path 仓库让 Laravel 正确加载本地包
假设 monorepo 结构如下：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
my-monorepo/ ├── composer.json ← 根 composer.json（全局仓库配置） ├── packages/ │ └── core/ │ ├── composer.json ← name: "acme/core", type: "library" │ └── src/ ├── apps/ │ └── web/ ← Laravel 应用 │ ├── composer.json ← require: "acme/core": "^1.0" │ └── ...
关键操作：
- 根
composer.json必须加repositories块，指向packages/*：
"repositories": [
{
"type": "path",
"url": "packages/*"
}
],
"minimum-stability": "dev",
"prefer-stable": true
- Laravel 应用的
composer.json中require的包名必须和子包composer.json里的name完全一致 - 子包
composer.json必须含autoload，例如："autoload": { "psr-4": { "Acme\Core\": "src/" } } - 执行
composer install时，必须在 Laravel 应用目录下运行（不是根目录），否则vendor不会生成到正确位置
autoload 冲突和 artisan 命令找不到的典型修复
即使 composer install 成功，php artisan tinker 里仍可能报 Class AcmeCoreFoo not found，原因通常是 autoload 没刷新或路径映射错位。
- 检查
vendor/composer/autoload_psr4.php是否已写入Acme\Core\对应的绝对路径（应指向my-monorepo/packages/core/src） - 如果没出现，运行
composer dump-autoload -o强制重生成（-o启用优化模式） - 确保子包的
src/下有Foo.php，且命名空间与文件路径严格匹配：namespace AcmeCore;→src/Foo.php - Artisan 命令类若放在子包中，需在 Laravel 应用的
config/app.php的providers数组里显式注册服务提供者，不能依赖自动发现（monorepo 下composer.json的extra.laravel.dont-discover可能干扰）
最易被忽略的一点：monorepo 里不同 Laravel 应用共用同一套 packages/，但每个应用的 vendor 是独立的。这意味着你改了 core 的代码，必须进每个用到它的 Laravel 应用目录，执行 composer update acme/core 或 composer install 才能同步变更——没有“一次构建，处处生效”这种事。
