源码湾

Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

源码湾
10月16日发布
资源信息 解压即用,含完整源码与已跑通的成品包。
今天的游客额度(10 个)已经用完了。登录之后不限量,也不用再等第二天。
版本
v5.7.0
授权
MIT
体积
9.6 MB
语言
Vue3
今日额度已用完 登录后不限量下载 去登录

今日下载 0 累计下载 0 还剩 0 个

接过后台项目的人都懂一个规律:不管你做什么业务,登录页、侧边菜单、多标签页、权限控制、主题切换,这套骨架每个项目都得重来一遍。更折磨的是你写完一遍,下个项目还得再写一遍。Vben Admin(vue-vben-admin)就是把这套骨架做到极致、开源给你用的 Vue3 前端底座,GitHub 33.6k Star,我装了一遍,说说它到底什么水平。

先说结论:它是目前 Vue3 中后台模板里工程化做得最深的项目之一。界面、权限、主题、国际化,全部开箱即用。代价是门槛不低——不会 Vue3 + TypeScript 的话,建议先补课。

7 张截图都是我在自己电脑上实测截的,装的过程和踩的坑都写在下面。

Vben Admin 是什么来头

一句话:Vue3 中后台项目的前端底座,不是成品业务系统。

拿若依对比一下就清楚了:若依是「后端功能 + 前端界面」全包的全家桶,Vben 只做前端这一半——但这一半做得非常深。

  • 版本:v5.7.0(本文实测版)
  • 协议:MIT,商用、改代码、闭源交付都不限
  • 技术栈:Vue 3.5 + Vite 8 + TypeScript 6 + Tailwind 4 + Turbo(monorepo 架构)
  • 包管理:pnpm 10(packageManager 锁死在 pnpm@10.33.4)
  • GitHub:33.6k Star
  • 官网:https://www.vben.pro

作者 vbenjs 团队。这个项目从 Vue2 时代就有名了,5.x 是纯 Vue3 重写的版本,维护节奏很稳。

它最有辨识度的一点:一套代码,5 种 UI 版本。Ant Design Vue、Element Plus、Naive UI、TDesign 各有一个完整版本(还有一个 antdv-next 尝鲜版),布局、权限、主题这些公共逻辑完全复用——你用惯哪套组件库就挑哪个,不用为了框架换组件库。

Vben 能干什么

对号入座:

  • 前端开发者做中后台:UI 骨架、路由、权限直接现成,你只管对着接口写业务
  • 独立开发者接私活:前端底子不用重搭,交付周期砍掉一大截
  • 想学工程化的前端:monorepo 拆包、TypeScript 类型体系、构建优化、代码规范,这套代码本身就是很好的学习素材

有一条必须说清楚:Vben 是纯前端,不带后端。你后端是 Java、Node 还是 Python,它都无所谓,给它 API 就行。想全套要后端功能,可以 Vben 前端 + 若依后端这么搭。

核心功能亮点

5 套 UI 版本

  • web-antd / web-antdv-next / web-ele / web-naive / web-tdesign
  • 布局、权限、路由、主题全共享,业务代码基本不用动

权限系统

  • 动态路由:菜单和路由从后端接口下发,按角色生成
  • 按钮级权限:v-access 指令直接控制按钮显隐
  • 支持前端固定 / 后端动态 / 混合三种权限模式

工程化配套(这才是它的强项)

  • 多标签页 + keep-alive 页面缓存
  • 主题定制:色板、圆角、暗色模式,调完可以一键复制配置
  • 国际化内置中英文
  • 内置 Nitro Mock 服务:后端没写好也能先把前端跑起来
  • ESLint / Stylelint / Commitlint / Lefthook 工具链全配好

界面实拍

登录页。默认账号已填好,滑块拖到最右就算通过(demo 环境的假验证,正式用要接真的):

vue-vben-admin-01-登录页 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

登录进来是分析页,顶部一排快捷入口,下面图表卡片全区:

vue-vben-admin-02-分析页 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

工作台页面。左侧数据卡片,右侧时间线 + 快捷操作,做数据看板可以直接参考这个布局:

vue-vben-admin-03-工作台 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

组件演示区。表单、表格、弹窗这些高频场景,Vben 都做成了演示页,开发时直接照着抄:

vue-vben-admin-04-组件演示 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

个人中心,左侧资料卡 + 右侧标签页。右上角显示当前登录用户(这是我改过品牌名的版本):

vue-vben-admin-05-个人中心 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

右上角设置抽屉是它的招牌功能:主题色、明暗模式、色弱模式、圆角、标签栏样式,全在这里调,调完还能一键复制配置:

vue-vben-admin-06-主题设置抽屉 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

一键切到浅色模式,整个框架所有页面跟着变,不用改一行代码:

vue-vben-admin-07-浅色模式 - Vben Admin 中后台模板源码:Vue3 + TypeScript,五套 UI

实测安装过程

实测环境:Windows + Node 22(要求 22.18+ 或 24+,版本不够直接罢工)+ pnpm 10。

1. 启用 pnpm

项目要求 pnpm 10 以上,我用 corepack 开的:

corepack enable

2. 安装依赖

pnpm install

项目自带 .npmrc,已经指向 npmmirror 淘宝镜像。我这边 6 分 39 秒装完。

3. 启动

pnpm dev:antd

这是 Ant Design Vue 版。其他版本换后缀就行:pnpm dev:ele(Element Plus)、pnpm dev:naive、pnpm dev:tdesign。

启动后端口是 5666,浏览器打开 http://127.0.0.1:5666,能看到登录页就成了。

4. 登录

账号 vben / admin / jack 三个,密码都是 123456。三个账号权限不同,想演示角色权限切换的时候正好用。

实话实说

优点:

  • 工程化水平在这类开源项目里属于第一档,代码组织本身就有参考价值
  • 5 套 UI 版本共享逻辑,换组件库的成本极低
  • 权限、主题、国际化这些「每个后台都要做」的部分全是现成的,拿来就是可用状态

缺点也得说:

  • 门槛不低。Vue3 + TypeScript 是硬要求,纯新手会被 monorepo 的目录结构劝退
  • 装依赖重。第一次 pnpm install 我花了 6 分 39 秒,机器和网络差点会更久
  • 动态路由有副作用:直接刷新深链接页面会 404(dev 模式行为,路由要等应用启动后恢复),得从首页点进去,第一次遇到容易懵
  • 开箱即用的是「框架」不是「业务」。菜单、权限的数据结构要跟你自己的后端对齐,mock 也要替换成真接口,这部分工作量别低估

常见问题

源码获取

上面测试用的完整包我整理好放夸克网盘了,免费取:

  • 完整源码(vue-vben-admin v5.7.0)——含本文实测的品牌名改动,pnpm install 后即可运行(依赖装法见上面教程)
  • 原版 LICENSE(MIT)+ 免责声明 + 跳转文件
  • 不含 node_modules——那玩意太大,源码包打出来只有 9.6MB,干干净净

上面记的这些坑,你自己走一遍也都会遇到。环境、依赖、配置、目录结构,一个都省不了。包里是我这边全部跑通之后才打的——要跳过这几步,直接拿下面这个。

两个小提醒:

  1. 建议先「转存到自己网盘」再下载——直接下载的链接容易失效,转存后就是你自己的了,随时能下;
  2. 手机上操作:点开链接 → 右下角「保存到网盘」→ 回夸克 App 的「我的网盘」里下载。

装之前确认一件事:Node 版本 22.18+ 或 24+,这是硬要求,低了第一步就卡住。

实测说明

本文截图全部来自本站实测环境(源码湾 yuanmawan.com),实测版本 Vben Admin v5.7.0,许可证 MIT。

© 版权声明
THE END
喜欢就支持一下吧
点赞 0 分享 收藏
评论 抢沙发
OωO
取消