React-Better-Admin v1.0.0 发布，一个 React + antd 的后台系统

React-Better-Admin 是一个基于 React 18、TypeScript、Ant Design v5.x 、React Router v6.x、Vite4、Redux、Redux Toolkit、RTK Query 开发的后台 UI 系统。

React-Better-Admin 特点

• 1、基于 TypeScript 🔥🔥🔥
• 2、基于最新的 React 18 🔥🔥🔥
• 3、基于最流行的设计风格 Ant Design v5.x 🔥🔥
• 4、基于 React Router v6.x 做路由管理，支持懒加载 🔥🔥
• 5、基于 Vite4 做项目编译打包工具 🔥🔥
• 6、基于 Redux、Redux Toolkit 做状态管理 🔥🔥
• 7、基于 RTK Query 请求管理 👍
• 8、完善的 国际化 配置支持 👍
• 9、完善的 登录认证 配置支持 👍
• 10、完善的 权限管理 + 动态菜单 配置支持 👍
• 11、完善的 Mock 数据支持
• 12、友好的代码风格和注释...
• 13、基于 MIT 开源协议，放心商用，永久免费 👍👍👍
• 14、更多小惊喜...

当前规划和进度

• ✅ 登录认证于退出
• ✅ 权限管理，当前用户的权限来源于服务器的配置
• ✅ 权限管理，自定是否拥有权限的 hook
• ✅ 统一的路由和菜单配置
• ✅ 中英文多语言切换 【 功能已完成，但某些按钮和地方未配置】
• ✅ RTK Query 请求拦截，所有请求自动添加 JWT 内容.
• ✅ 高阶组件：DictSelect (能够根据服务器数据字典自动设置下拉数据)
• 高阶组件：CrudPage（通过配置自动生成 增删改查 的组件）

为什么不用 Ant Design Pro

Ant Design Pro 是 Ant Design 官方推出的非常优秀的、开箱即用的、中台前端解决方案，而 React-Better-Admin 也是向 Ant Design Pro 学习，对标 Ant Design Pro，打造 "另一套" 优秀的、开箱即用的、中台前端解决方案。

为什么不直接用 Ant Design Pro ，而全新开发 React-Better-Admin 呢？ 我们团队主要认为有以下几个原因：

• 1、Ant Design Pro 是基于阿里自己的 Umi 进行开发的，我们团队不熟悉 Umi ，并且 Umi 并不像 Redux、Vite4、React Router 那么流行（不给出数据了）。

• 2、Umi 自己包含了代码构建、测试、路由、状态管理等能力，它既是一个打包工具、也是一个运行时依赖框架，从用户需求角度来讲： Umi = Vite4 + React Router + Redux + RTK Query （或者 Axios 等）。但是，在 React 的生态中，我们除了使用 React 来构建 web 产品以外，还可能通过 React-Native 来构建 app 应用，在这方面： React Router、Redux 都是支持非常友好，而 Umi 视乎没有太多案例。

• 3、我们（包括用户）基于 React-Better-Admin 开发出的商业产品进行销售的时候，客户公司的 ”技术架构师“ 往往有很重话语权，而纵观整个互联网，使用 "React Router + Redux" 的架构师，好像要比 Umi 多一些。

但无论如何，Ant Design Pro 非常优秀，我们努力向它靠齐。 

开始使用

Clone

 git clone https://gitee.com/better-admin/react-better-admin.git

Install

 cd react-better-admin npm install

Run

 vite

Build

 # 开发环境 npm run build:dev # 测试环境 npm run build:test # 生产环境 npm run build:pro 

目录结构

 . ├── docs # 文档内容 ├── mock │ └── api.mock.ts # 开发环境的 Mock 数据定义 ├── public # 静态资源文件目录  ├── src │ ├── apis # API 定义目录 │ ├── assets # 资源文件 │ ├── components # 通用组件定义 │ ├── context # React Context │ ├── hooks # React 自定义 Hook │ ├── layout # 布局文件以及布局涉及的组件 │ ├── locales # 国际化语言定义 │ ├── pages # 页面文件夹 │ ├── routers # 路由和菜单的定义 │ ├── store # redux store 定义 │ ├── App.tsx # React 运行入口文件 │ ├── main.tsx # 入口文件 │ └── vite-env.d.ts # Vite 声明文件 ├── index.html # 应用运行入口文件 ├── LICENSE # 授权文件（MIT） ├── package-lock.json # 依赖包版本锁定文件 ├── package.json # NPM 管理 ├── readme.md  ├── tsconfig.json # TypeScript 配置文件 ├── tsconfig.node.json ├── vite.config.ts # Vite 配置文件 

常见问题

问题1：新建的页面显示没有权限？

答：原因是整个系统添加了权限管理，用户只能访问有权限的页面，新添加的页面没有给当前用户分配权限，需要在 mock/api.mock.ts 文件中的 /api/account/permissions 里，添加新创建的页面对应的 URL（路由）地址。

进一步了解：https://gitee.com/better-admin/react-better-admin