Fantastic-admin 官方文档

Appearance

为什么选择 Fantastic-admin ？ ​

如果你想找的只是一个“能跑起来”的后台模板，那么市面上的选择其实很多。

但如果你要的是一套适合长期维护、支持持续扩展、对 AI 友好、并且经过市场验证的工程底座，那么 Fantastic-admin 想解决的就不是“把页面搭起来”这么简单。

它更像是一套为真实项目准备好的后台开发系统：有统一的工程组织方式，有成体系的导航与路由设计，有可扩展的布局能力，也有让 AI 更懂你项目结构的 Skills 体系。

它适合什么样的团队？ ​

Fantastic-admin 尤其适合下面这些场景：

  • 想快速启动一个中后台项目，但又不想后期越做越乱
  • 团队里前端人数有限，希望降低业务页面搭建成本
  • 项目需要长期演进，未来可能扩成多应用、多主题、多布局形态
  • 希望把 AI 真正引入开发流程，而不是只把 AI 当聊天工具
  • 需要兼顾开发效率、界面质量、工程规范三者的平衡

长期维护，而不是一次性产物 ​

Fantastic-admin 自 2020/10/17 对外发布以来，截止今天已持续维护 1993 天。

这意味着它不是一个“演示效果很好、真正落地时问题很多”的短期项目，而是一套经过长期迭代、不断打磨后形成的方法论型框架。

对后台系统来说，长期维护能力往往比“第一眼惊艳”更重要。因为后台项目一旦上线，真正的挑战往往不是从 0 到 1，而是之后不断增加页面、角色、权限、菜单、布局和业务模块时，工程是否还能保持清晰。

1. 面向 AI 的后台开发方式 ​

Fantastic-admin 的一个非常明显的差异点，是它不是简单地“支持 AI”，而是把后台开发中的高频动作，沉淀成了一套可复用的 AI Skills。

你可以把它理解为：不是让 AI 凭空猜你的工程规范，而是直接把框架的目录约定、实现方式和推荐路径告诉 AI。

当前文档里已经收录了多种 Skills，例如：

这带来的好处不是“多了几个提示词模板”，而是：

  • AI 更容易理解 Fantastic-admin 的目录结构和工程约定
  • AI 生成的代码更接近项目现有风格，而不是通用模板代码
  • 从 CRUD、表单到路由、主题、插槽，都可以走同一套协作方式
  • 当需求反复修改时，还能进入统一的反馈流程，而不是每次重新来过

更重要的是，项目里的 Skills 采用 SKILL.md 这种开放格式统一维护在 .agents/skills/ 中，不只可用于单一工具，也更适合未来持续演进的 Agent 工作流。详细可阅读：AI 技能 (Skills)

2. 更适合长期项目的 pnpm monorepo 架构 ​

很多后台模板在一开始看起来很轻，但项目一大，目录结构就会逐渐失控：应用代码、公共组件、主题配置、文档、工程脚本全堆在一起，短期方便，长期难维护。

Fantastic-admin 从工程组织上就避免了这个问题。它使用的是 pnpm monorepo，并把核心能力按职责拆开：

text
├── apps/*        # 业务应用
├── packages/*    # 可复用能力（组件、设置、主题等）
└── docs          # 文档站

这种结构的价值在于：

  • 业务与框架能力边界清晰：应用代码不会和公共能力缠在一起
  • 更适合多应用扩展：以后新增 apps/admin、apps/tenant 这类应用时更自然
  • 公共能力可沉淀复用：组件、设置、主题不必复制粘贴
  • 文档可以跟着代码同步演进：减少“代码更新了，文档还停在旧版本”的割裂感

如果你希望项目不是只服务一个短周期页面，而是能支撑一个产品长期发展，那么 monorepo 带来的收益会非常明显。

3. 技术栈现代，但重点不只是“新” ​

Fantastic-admin 当前采用的核心技术栈包括：

  • Vue 3.6
  • TypeScript
  • Vite 8
  • Vue Router 5
  • Pinia
  • UnoCSS
  • vue-i18n
  • Element Plus（默认）
  • Reka UI（内建组件底层实现）

这些技术栈本身当然足够现代，但更重要的是它们组合在一起后，服务的是后台项目最常见的几个目标：

  • 开发体验足够顺手：Vite、TS、Vue 3 的组合已经非常成熟
  • 状态与路由体系清晰：Pinia + Vue Router 更适合中后台场景的组织方式
  • 样式迭代效率高：UnoCSS 让大量界面微调变得更轻，适合高频业务开发
  • 国际化与主题能力更容易落地：不是后期硬补，而是默认具备扩展空间

所以它的价值不只是“用了新技术”，而是这些技术被放进了一个适合后台项目的工程结构里。

4. 布局和导航不是点缀，而是生产力 ​

很多后台框架在首页会展示很多皮肤和主题，但真正落到业务里，往往只能用一种布局、一种导航结构，最后所有项目都长得差不多。

Fantastic-admin 更重视的是：同一套业务能力，能不能适配不同的信息架构和产品阶段。

页面布局更灵活 ​

围绕内容宽度与页面承载方式，框架支持多种布局形态，例如：

  • 自适应布局
  • 内层居中布局
  • 外层居中布局

这意味着你可以根据项目气质、屏幕利用率和内容密度来决定页面风格，而不是被固定模板限制住。相关文档可阅读：应用设置 / 布局

导航菜单模式更丰富 ​

Fantastic-admin 的导航不是单一的左侧菜单，而是支持按场景切换组织方式。

基础模式包括：

  • head
  • side
  • single

专业版进一步扩展：

  • only-side
  • only-head
  • side-panel
  • head-panel

也就是说，专业版一共提供 7 种导航菜单模式。这背后不是为了“看起来花样多”，而是为了适配不同后台产品的真实需求，例如：

  • 模块特别多时，需要更强的层级承载能力
  • 一级入口很重要时，希望顶部导航更突出
  • 既要主导航又要次导航时，希望信息组织更清晰
  • 面向不同甲方或品牌项目时，希望快速调整视觉与交互结构

相关文档可阅读：导航菜单

5. 路由、菜单、权限、缓存不是零散功能，而是一套闭环 ​

Fantastic-admin 的一个核心思路是：导航本质上应由路由驱动，而不是额外维护两套数据。

在项目里，路由模块放在 apps/<app>/src/router/modules/ 下，每个文件都是一个独立模块，最后统一在 routes.ts 中组织到不同的主导航菜单里。

这带来的好处非常直接：

  • 路由结构和导航结构天然一致
  • 菜单的标题、图标、徽章、权限、高亮、缓存等能力都能通过路由元信息统一管理
  • 单个模块的位置可灵活调整，而不影响业务路径
  • 更适合多人协作和中大型后台的持续扩展

对开发者来说，这不是“又一套配置”，而是少维护一套系统。

如果你做过复杂后台项目，会知道真正麻烦的不是写一个菜单，而是后面不断叠加：

  • 哪些页面显示在菜单里
  • 哪些页面不显示但要高亮指定菜单
  • 哪些页面需要权限控制
  • 哪些页面需要保活
  • 哪些页面需要标签页合并或特殊跳转行为

Fantastic-admin 把这些问题放进了同一套路由与导航体系中，因此更适合真实业务，而不只是演示页。详细可阅读：路由（导航菜单）、权限、页面缓存

6. 风格不是简单换色，而是可以塑造产品气质 ​

后台系统当然首先是效率工具，但这并不意味着界面风格不重要。

一个长期使用的后台，视觉系统是否统一、布局是否克制、交互是否舒服，会直接影响团队每天使用它时的感受。

Fantastic-admin 在这方面提供的不是单点配置，而是一整套组合能力：

  • 明暗模式切换
  • 主题体系
  • 导航风格定制
  • 页面布局切换
  • 工具栏与标签栏相关配置

同时，如果你希望进一步做品牌化定制，项目还提供了 fa-theme-customizer 这类 Skill，让 AI 可以直接帮助你生成和落地主题方案。

7. 可替换、可扩展，而不是“只能按作者方式开发” ​

一个真正能陪项目走很久的框架，不能只提供默认答案，还要留出足够大的扩展空间。

Fantastic-admin 在这方面给出的能力包括：

可替换 UI 组件库 ​

默认使用 Element Plus，但你也可以根据团队偏好替换为其他 UI 组件库，例如：

这意味着你不必因为框架的默认视觉选择，而放弃它的工程能力。

预留插槽能力 ​

框架支持在布局中的多个位置注入自定义内容，例如头部、侧边、工具栏、页面上下方等区域。

这对真实项目特别重要，因为很多后台最终都会遇到：

  • 在头部加组织切换
  • 在布局顶部加公告横幅
  • 在底部加自定义信息区
  • 在工具栏或导航旁插入业务入口

相关文档可阅读：预留插槽

国际化与状态管理能力 ​

对于需要做多语言、跨页面共享状态、页面级配置扩展的项目来说，框架也给出了比较明确的落地路径：

8. 对后端、全栈和中小团队更友好 ​

Fantastic-admin 一直有一个很实际的优势：它不是只为“纯前端团队”准备的。

对很多后端、全栈或中小团队来说，真正需要的不是一套过于抽象的前端架构，而是一套：

  • 看得懂
  • 改得动
  • 能扩展
  • 文档能跟上
  • 页面和功能都有真实落地参考

Fantastic-admin 在这些维度上更接近“可直接投入业务”的状态。你可以从文档、示例应用、业务页面、内建组件和 Skills 一起开始，而不是先花大量时间把工程骨架重新拼起来。

总结：Fantastic-admin 的价值，不只是“功能多” ​

很多框架也能做主题、做菜单、做权限、做页面。

Fantastic-admin 更想解决的是另外一个问题：这些能力能不能组成一套长期可用的后台开发体系。

它的价值在于：

  • 用 AI Skills 降低后台开发和协作成本
  • 用 pnpm monorepo 提前解决长期维护问题
  • 用 多布局 + 多导航模式 适配不同产品形态
  • 用 路由驱动菜单与权限 保持系统一致性
  • 用 主题、插槽、组件替换能力 留出足够扩展空间

如果你需要的是一个只演示几张漂亮页面的模板，那么它也许不是最“轻”的那个。

但如果你要的是一套能够陪项目一起成长、并且已经为未来的 AI 协作方式做好准备的后台框架，那么 Fantastic-admin 值得认真看看。

Copyright © 2020-present Fantastic-admin