新一代中后台管理系统
可复用 · 可扩展 · 可快速交付
一款清爽、美观、开箱即用的现代化中后台前端框架，为全栈工程师、前端及
后端工程师量身打造。业务无关的企业级中后台前端脚手架。
CORE VALUES
脚手架的三大核心价值
所有菜单、页面、权限均由后端动态下发，前端不硬编码任何业务逻辑
业务无关
更换一套后端接口，它就是另一个全新的管理平台。无论零售电商、仓储物流、内容运营、企业 OA，都可基于此快速搭建。
按需组装
内置多种通用业务模块（权限管理、基础数据、内容运营、系统配置等），均可根据实际业务自由选择、裁剪或扩展。
即插即用
新增一个业务模块，只需创建页面文件 + 后端注册菜单资源，前端侧边栏自动出现新菜单，无需修改任何路由配置文件。
TECH STACK
技术架构概览
坚持“选最新的、用最稳的”原则，所有技术选型均为当前社区最活跃、生态最健全的方案
SIX-LAYER ARCHITECTURE
六层解耦架构
从底层状态到顶层路由，每一层职责分明、独立可替换
CORE HIGHLIGHTS
核心亮点 — 动态菜单与业务模块的灵活组装
前端不决定“有什么菜单”，后端说了算 —— 这是本脚手架最核心的设计理念
动态菜单工作机制
不同角色不同菜单
管理员看到全部模块，运营只看运营相关，完全由后端权限控制
模块自由组合
上线新模块或下线旧模块，只需修改后端配置
新增模块无需改路由
创建页面文件，注册菜单资源，侧边栏自动出现新菜单项
跨行业通用
A做零售 B做仓储 C做OA，后端配置不同菜单树即可
ENTERPRISE READY
开箱即用的企业级能力
动态菜单 & 权限
菜单由后端动态下发，与 RBAC 权限体系深度联动，前端零配置
多主题 & 暗黑模式
20+ 精心调校的主题色，深浅模式一键切换，支持跟随系统自动适配
统一 CRUD 模式
搜索+表格+分页+增删改查，统一交互范式，学习成本趋近于零
类型安全全链路
从 API 响应 → Store 状态 → 组件 Props，TypeScript 全覆盖
多环境部署
开发/测试/生产三套环境一键切换，环境变量隔离
国际化 & 响应式
i18n 支持中/英文切换，移动优先设计，适配多种屏幕尺寸
DEV EXPERIENCE
高效开发体验 & 面向未来的技术底座
高效开发特性
COMPONENT SYSTEM
自定义组件体系
90% 的页面开发不用写基础代码，封装中后台最常见的交互模式
JSON 配置驱动 · Zod Schema 校验 · 16 种字段类型 Grid/Vertical/Horizontal 布局 · 字段联动 远程搜索 · 数据转换 · 表单引用
列配置驱动 · 自定义渲染 · 固定列 Left/Right 行选择单选/全选 · 分页集成 · 7 种行事件 斜纹/悬停效果 · 加载空态 · 表头操作区
sm~7xl 预设宽度 · 最大化切换 三区结构 · 加载/提交状态 · 防误关
danger/warning/success 三种语义 颜色图标自动匹配 · 异步 onConfirm
image/video/file 三种媒体 · 拖拽上传 多图模式 · 拖拽排序 · 实时预览/进度
单选/多选统一 · Badge 标签 远程搜索防抖 · 空态/加载态
双日历联动 · 精确到秒 中文本地化 · 输入格式自动校验
showMessage/Error/Warning/Loading 四种语义 · 9 种图标 · 一行代码触发
多级数据级联选择，树形结构逐级展开。弹窗式交互模式，适合数据量较大的场景。
Button · Input · Select · Dialog · Table · Card · Badge · Avatar · Tooltip · Popover · Calendar · Form · Progress · Skeleton · ScrollArea · Breadcrumb · Sidebar · Toast ... 源码完全在项目中，可随时定制。
API INTEGRATION
与后端对接规范设计
统一的请求-响应-异常三层处理机制，后端照着文档实现，前端零配置接入
Axios 拦截器自动注入 Token 请求头，后端无需关心前端如何传递认证信息。
后端统一返回 { code: "OK", data: {...}, msg: "操作成功", count: 100 }
UN_LOGIN → 跳转登录页 业务错误 → Toast 提示 网络超时 → 友好异常提示
登录认证
前端加密密码 → 后端返回 JWT Token → 前端自动解析并持久化
请求鉴权
每次请求自动携带 Token 头，后端校验即可
菜单权限
后端下发当前用户可见菜单，前端动态渲染
角色授权
后端提供资源树 + 角色关联，前端提供树形勾选界面
WHY CHOOSE US
为什么选择 Easy Admin？
yarn dev 一条命令 3 秒启动开发环境
统一 CRUD 模式 新人半天上手
Shadcn/ui 源码在手 任何 UI 需求都能满足
TS 智能提示 热更新、错误边界
标准化接口规范 前端零配置接入
菜单动态生成 一套代码多种业务
SCENARIOS
适用场景
零售/电商后台
商品+订单+会员+运营+基础数据
仓储/物流管理
设备+商户+基础数据
企业 OA 后台
权限（部门/角色/员工）+系统配置
内容运营平台
Banner+字典+基础数据
SaaS 多租户平台
租户管理+全部模块
教育/医疗/金融...
按需自选，后端配菜单前端自动生成
SHOWCASE
效果展示
实际项目效果预览，眼见为实
QUICK START
快速上手
环境要求：Node.js ≥ 18，Yarn ≥ 4.7.0