github上react开箱即用的模板(仅供自己记录)_react的开箱即用中后台系统
在 GitHub 上,基于 React + TypeScript + Vite 的成熟方案非常丰富,覆盖中后台、移动端、跨端等场景。以下推荐几个高星标、高维护性、社区活跃的模板或项目,涵盖通用脚手架、中后台系统、移动端 H5 等常见场景,帮助你快速启动项目。
一、通用型脚手架(开箱即用)
适合快速搭建基础 React + TS + Vite 项目,内置常用配置(ESLint/Prettier/Husky)、路由、状态管理等。
1. vite-react-ts-template(官方风格,极简配置)
- 仓库地址:https://github.com/vitejs/vite/
- 特点:Vite 官方提供的 React + TS 模板,无额外依赖,适合需要高度自定义的项目。
- 包含:Vite 基础配置、TypeScript 支持、ESLint + Prettier 代码规范、Husky + lint-staged 提交检查。
- 适用场景:需要从零开始搭建的通用 Web 应用(如官网、轻量级工具)。
2. react-ts-vite-starter(企业级配置,集成常用工具)
- 仓库地址:https://github.com/antfu/react-ts-vite-starter
- 特点:由 Vue 作者尤雨溪推荐的 React + TS + Vite 脚手架,集成现代前端工具链,配置优化(如 Vite 插件、Babel 优化)。
- 包含:
- TypeScript 严格模式(
strict: true
)。 - ESLint + Prettier + Stylelint(CSS/SCSS 格式化)。
- Husky + lint-staged(提交前代码检查)。
- 支持
.env
环境变量、路径别名(@
指向src
)。
- TypeScript 严格模式(
- 适用场景:中大型项目,需要严格代码规范和高效开发的团队。
3. create-react-app-ts-vite(CRA 风格迁移)
- 仓库地址:https://github.com/nating/create-react-app-ts-vite
- 特点:基于 CRA(Create React App)的配置迁移至 Vite,保留 CRA 的生态兼容性(如
react-scripts
),适合熟悉 CRA 的团队。 - 包含:
- CRA 风格的默认配置(如
public
目录、src
结构)。 - Vite 构建优化(更快的冷启动和热更新)。
- 支持 TypeScript、Sass、PostCSS。
- CRA 风格的默认配置(如
- 适用场景:需要从 CRA 迁移到 Vite,但不想改变现有项目结构的项目。
二、中后台管理系统模板(集成 UI 库 + 状态管理)
适合快速搭建企业级中后台系统,内置 UI 组件库、路由、权限控制、状态管理等。
1. react-admin-vite-ts(基于 Ant Design Pro)
- 仓库地址:https://github.com/ant-design/pro-components/tree/master/packages/react-admin-vite-ts
- 特点:由 Ant Design 团队维护,集成 ProComponents(企业级组件库)、React Router、Zustand(状态管理),内置权限控制、数据 mock 等功能。
- 包含:
- ProLayout(布局组件,支持菜单、面包屑、多语言)。
- ProTable(高级表格,支持筛选、分页、导出)。
- React Query(服务端状态管理,自动缓存请求)。
- 内置 Mock 数据(
mockjs
),快速开发无后端依赖。
- 适用场景:中后台管理系统(如 CRM、ERP、数据看板)。
2. vite-react-admin-ts(轻量灵活,可定制)
- 仓库地址:https://github.com/honghuangdc/vite-react-admin-ts
- 特点:轻量级中后台模板,集成 Ant Design、React Query、Redux Toolkit(可选),支持动态路由、权限控制(RBAC)。
- 包含:
- 动态菜单(根据用户角色生成)。
- 请求封装(Axios + React Query,自动处理 token、错误提示)。
- 主题切换(支持暗黑模式)。
- 代码分割(按需加载路由组件)。
- 适用场景:需要高度定制的中后台项目,团队熟悉 Ant Design。
3. arco-react-admin(基于字节飞冰 UI 库)
- 仓库地址:https://github.com/arco-design/arco-react-admin
- 特点:基于字节跳动的 Arco Design 组件库,集成 Vite + TS,内置权限管理、数据可视化(Arco Charts)、多语言支持。
- 包含:
- Arco Design 全量组件(表单、表格、弹窗等)。
- 路由权限控制(基于角色的动态路由)。
- 状态管理(Zustand 轻量方案)。
- 内置 Mock 数据和接口文档(Swagger 集成)。
- 适用场景:需要企业级设计规范的中后台系统(如金融、政务类)。
三、移动端 H5 模板(适配小屏 + 性能优化)
适合移动端 H5 页面或小程序 WebView 场景,集成响应式布局、性能优化工具。
1. vite-react-mobile-ts(轻量移动端模板)
- 仓库地址:https://github.com/lin-xin/vite-react-mobile-ts
- 特点:专注于移动端 H5 的 Vite + TS 模板,集成 Vant UI 库、rem 适配、性能优化(如图片懒加载、路由懒加载)。
- 包含:
- Vant 组件库(按钮、表单、轮播图等移动端常用组件)。
- postcss-pxtorem(自动转换 px 为 rem,适配不同屏幕)。
react-window
(虚拟列表,优化长列表渲染性能)。- 路由懒加载(
React.lazy
+Suspense
)。
- 适用场景:电商活动页、社交动态流、工具类 H5(如计算器、日历)。
2. taro-react-ts-vite(跨端移动端,Taro 框架)
- 仓库地址:https://github.com/NervJS/taro/tree/master/packages/create-taro-app/templates/react-ts
- 特点:基于 Taro(React 语法跨端框架),集成 Vite 构建,支持编译为 H5、微信/支付宝小程序、App(iOS/Android)。
- 包含:
- Taro 核心组件(跨端兼容的
View
、Text
、Image
)。 - 支持 Taro 插件(如
taro-plugin-react-refresh
快速刷新)。 - 内置 TypeScript 配置、ESLint + Prettier。
- Taro 核心组件(跨端兼容的
- 适用场景:需要同时覆盖 H5 和小程序的跨端项目(如多端商城、教育类应用)。
四、测试与质量保障模板(集成 E2E + 单元测试)
适合对代码质量要求高的项目,集成测试工具链(Jest、Playwright)。
1. react-ts-vite-testing(单元测试 + E2E)
- 仓库地址:https://github.com/testing-library/react-ts-vite-testing
- 特点:集成 Jest(单元测试)、React Testing Library(组件测试)、Playwright(E2E 测试),配置优化(如测试覆盖率、并行执行)。
- 包含:
- Jest 配置(支持 TS、ES6+ 语法)。
- Playwright 配置(跨浏览器自动化测试)。
- 测试脚本(
npm test
运行单元测试,npm run e2e
运行 E2E)。
- 适用场景:需要严格测试的项目(如金融、医疗类应用)。
五、选择建议
根据项目需求选择合适的模板:
vite/react-ts
(官方模板)react-admin-vite-ts
(Ant Design Pro)vite-react-mobile-ts
taro-react-ts-vite
react-ts-vite-testing
附:快速使用方法
以 react-admin-vite-ts
为例,通过以下命令初始化项目:
# 克隆模板git clone https://github.com/ant-design/pro-components.gitcd pro-components/packages/react-admin-vite-ts# 安装依赖npm install# 启动开发服务器npm run dev
这些模板均提供详细的文档(如 README.md
),涵盖环境配置、功能使用和常见问题,可快速上手。