blueprint

写一份 YAML 蓝图，自动生成 Laravel 全套代码

Blueprint 是面向 Laravel 开发者的代码生成工具，通过读取一份 YAML 蓝图文件，一次性生成模型、迁移、控制器、路由、表单请求、事件、任务、测试等整套代码骨架。它解决的是 Laravel 项目里重复编写样板代码、手写迁移与模型容易遗漏关联和字段的问题。核心能力包括：用声明式 DSL 描述数据模型与业务动作，自动推导 Eloquent 关系、迁移字段和验证规则；支持生成 API 资源、策略、工厂、Seeder；可自定义模板与 stub，适配团队规范；还能在已有项目上增量生成而不覆盖手写逻辑。开发者只需维护蓝图文件，就能让代码结构与数据设计保持同步，显著减少初期搭建和后续扩展的机械劳动，适合中大型 Laravel 应用快速起步与迭代。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3112

维护状态较活跃

是否开源是

定价模式 free

项目预览

项目数据

分类编程开发

开发团队laravel-shift

所属国家

官网地址

GitHubhttps://github.com/laravel-shift/blueprint

定价模式free

价格说明开源免费工具

访问状态

是否开源是

开源协议MIT

主要语言PHP

技术栈/模型

GitHub 星标★ 3112

30天Star增速

HF 下载量

上线时间2019-10-14 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-04

浏览次数0

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 5 分钟部署方式：库/依赖 4 步

环境要求

已安装 Composer 的 PHP 环境
一个 Laravel 11 或更高版本的 Laravel 应用

安装与启动步骤

1安装 Blueprint

在 Laravel 项目根目录用 Composer 以开发依赖方式安装，包会自动注册，无需手动配置服务提供者。
```
composer require -W --dev laravel-shift/blueprint
```
2安装测试断言包

可选步骤。若想运行 Blueprint 生成的测试，需要额外安装 laravel-test-assertions 包。
```
composer require --dev jasonmccreary/laravel-test-assertions
```
3编写 draft 蓝图文件

用 YAML 声明要生成的组件，例如在 models 下定义字段、在 controllers 下定义动作与语句。
4生成 Laravel 组件

运行 Artisan 命令，Blueprint 会依据 draft 文件一次性生成模型、迁移、控制器、路由等代码。
```
php artisan blueprint:build
```

如何确认成功

执行 php artisan blueprint:build 后无报错，项目中出现对应的模型、迁移、控制器、路由等生成文件。

常见问题

Q：需要哪个 Laravel 版本？

A：README 说明当前支持 Laravel 11 或更高版本，低版本无法使用。

Q：需要手动注册服务提供者吗？

A：不需要，Blueprint 会通过 Laravel 的包自动发现（package discovery）自动注册。

Q：生成的测试运行失败怎么办？

A：需要额外安装 jasonmccreary/laravel-test-assertions 包。另外示例假设默认应用自带 User 模型与 app.blade.php 布局。

注意事项

Blueprint 通过 Composer 以 --dev 开发依赖方式安装。
若要在已有项目中使用，注意生成的测试可能依赖默认 Laravel 应用的 User 模型与 app.blade.php 布局。
README 未给出 draft 文件的默认路径，实际路径请以 Blueprint 官方文档为准。

核心亮点

用 YAML 声明模型和动作，一次生成迁移、模型、控制器、路由、测试等多层代码，减少重复劳动
自动推导 Eloquent 关联、字段类型和验证规则，降低手写遗漏与不一致的风险
支持自定义 stub 模板，能按团队规范调整生成结果，并可在已有项目上增量生成

不足之处

仅面向 Laravel 生态，非 Laravel 或非 PHP 项目无法使用
蓝图 DSL 需要额外学习成本，复杂业务场景下生成结果可能仍需手工调整

适用场景

新 Laravel 项目快速搭建数据模型与 CRUD 骨架
团队统一代码规范，用自定义 stub 批量生成标准结构
已有项目新增模块时，按蓝图增量生成迁移、模型和测试

替代项目

Laravel Generator、InfyOm Laravel Generator

项目介绍

blueprint 是编程开发领域的开源项目，由 laravel-shift 开发，2019 年首次发布。

在全站 13,635 个收录项目中，它的 GitHub 星标数（3,112）位列前 30%，在编程开发分类的 529 个项目里位列前 14%。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-25。开源免费工具。

它主要面向的使用场景是：新Laravel项目快速搭建数据模型与CRUD骨架。同类可对比的替代方案包括 Laravel Generator、InfyOm Laravel Generator。

上一篇：easy-agent

下一篇：没有了！