SoybeanAdmin Vue3 管理后台模板:克隆到跑起来只需 3 条命令
【免费下载链接】soybean-adminA clean, elegant, beautiful and powerful admin template, based on Vue3, Vite7, TypeScript, Pinia, NaiveUI and UnoCSS. 一个清新优雅、高颜值且功能强大的后台管理模板,基于最新的前端技术栈,包括 Vue3, Vite8, TypeScript, Pinia, NaiveUI 和 UnoCSS。项目地址: https://gitcode.com/GitHub_Trending/soy/soybean-admin
新做一个中后台系统,最耗时的往往不是业务页面,而是权限路由、主题、异常页、国际化这类地基活。SoybeanAdmin 是一套把这些活提前干好的管理后台模板:仓库克隆下来,你写的每一行代码都直接进业务层。
SoybeanAdmin 替你干了哪些活
底层是 Vue3 + Vite8 + TypeScript + Pinia + NaiveUI + UnoCSS 的组合,pnpm monorepo 组织;价值在于权限、主题、路由这些容易踩坑的部分全部强类型且开箱可用。
权限路由如何切前端静态与后端动态
中后台最常见的坑是权限方案:菜单写死,还是后端下发,二选一。模板两者都支持——路由上声明角色,启动时按当前用户角色过滤,侧边菜单和面包屑由同一份路由反推生成。切换策略不用动页面层,逻辑集中在 src/store/modules/route/,排查起来不用满仓库找。
主题主色、布局、暗色模式怎么改
打开右侧主题抽屉,主色、圆角、暗色、灰度/色弱模式、五种布局模式都能在线调,改完立刻生效 🎨。背后是 CSS 变量加 UnoCSS 的方案,预设文件如 src/theme/preset/default.json 就是配置起点,想换品牌色不用翻组件。
新建页面如何自动生成路由
文件式路由接管 pages 目录,新增页面自动生成路由导入、声明和类型提示,不用手动注册。开发环境接在线 Mock 数据(README 注明基于 ApiFox),没有后端接口也能跑通全流程;403/404/500 异常页、密码/验证码登录这些页面也都内置好了。
如何本地启动这个 Vue3 管理后台
环境门槛略高:Node ≥ 20.19、pnpm ≥ 10.5(monorepo 项目,npm 和 yarn 不适用)。截至本文发布时,仓库版本号为 2.2.0 ⚡。启动只需要三条命令:
git clone https://gitcode.com/GitHub_Trending/soy/soybean-admin cd soybean-admin && pnpm i pnpm dev跑起来后可以先走一遍登录、首页、权限页面验证各功能,仓库根目录 README 的「使用」一节有同样的步骤说明。
SoybeanAdmin 适合谁,谁不必考虑
适合:新起管理后台、想跳过地基活直接写业务的项目;需要统一代码基线的团队,仓库里 eslint、类型检查、提交规范都是配置好的;想拿一个实操案例学最新前端栈的开发者。布局本身做了移动端适配,轻度移动办公场景也能覆盖。
不适合:技术栈锁死 Element Plus 或 Ant Design 的项目(本仓库是 NaiveUI 版本,其他组件库版本由作者另行维护);单页工具站、小程序这类形态,中后台模板的结构对它过重;需要对底层路由或主题架构做深度定制改造的项目——"开箱即用"的那层反而会变成要拆掉的东西。
如果下一个项目正好是标准中后台,建议先克隆仓库跑一遍;觉得省了事,点个 star 就是最直接的支持。
以上信息基于项目仓库整理,最新动态请以项目主页为准
【免费下载链接】soybean-adminA clean, elegant, beautiful and powerful admin template, based on Vue3, Vite7, TypeScript, Pinia, NaiveUI and UnoCSS. 一个清新优雅、高颜值且功能强大的后台管理模板,基于最新的前端技术栈,包括 Vue3, Vite8, TypeScript, Pinia, NaiveUI 和 UnoCSS。项目地址: https://gitcode.com/GitHub_Trending/soy/soybean-admin
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考