以下是一个 React 项目中常见的依赖项说明及建议安装方式(适配 React 19 环境)。
✅ 第三方库说明
包名 | 说明及用途 |
---|---|
prop-types | 用于类型检查 React 组件的 props(非必须,但可提升可维护性) |
react-jss | 使用 JSS(JavaScript Style Sheets)在 React 中做 CSS-in-JS |
axios | 流行的 HTTP 请求库,用于与后端通信 |
qs | 序列化和解析 URL 查询字符串(query string) |
blueimp-md5 | MD5 加密函数,常用于用户密码、签名等 |
echarts | 图表可视化库(适合大屏、仪表盘、折线图等) |
fastclick | 移动端解决 300ms 点击延迟问题(在现代浏览器中已较少使用) |
antd | Ant Design,主流 PC 端 UI 框架 |
antd-icons | 辅助使用 Ant Design 图标(较老版本或自定义库) |
antd-mobile | 移动端 UI 框架,适合小程序/H5 |
antd-mobile-icons | Antd Mobile 的图标库 |
@reduxjs/toolkit | Redux 官方推荐状态管理工具包 |
redux | 核心状态管理库 |
redux-logger | Redux 日志打印中间件 |
redux-promise | 支持返回 Promise 的 Redux 中间件 |
redux-thunk | Redux 中处理异步 Action 的中间件 |
react-redux | React 与 Redux 的绑定库 |
react-router-dom | React 路由库(建议 v6+) |
http-proxy-middleware | 本地开发中配置代理接口 |
lib-flexible | 移动端适配布局库(结合 rem 方案) |
postcss-pxtorem | 自动将 px 转换为 rem 的 PostCSS 插件 |
cross-env | 跨平台设置 NODE_ENV 等环境变量 |
less | 使用 Less 预处理器编写样式 |
less-loader | Webpack 中加载 less 文件的加载器 |
🚀 适配 React 19 的安装命令建议
确保你使用的是 React 19 的最新版:
npm install react@latest react-dom@latest
安装其他依赖(推荐按需选择)
npm install prop-types react-jss axios qs blueimp-md5 echarts fastclick antd @ant-design/icons antd-mobile @reduxjs/toolkit redux redux-logger redux-promise redux-thunk react-redux react-router-dom http-proxy-middleware lib-flexible postcss-pxtorem cross-env less less-loader
⚠️ 注意:
antd-icons
和antd-mobile-icons
为非官方维护的库,建议统一使用@ant-design/icons
。fastclick
在现代浏览器(移动端)上可选用,因为主流浏览器已原生支持快速响应。
🧠 附:React 19 新特性概览
- 自动缓存与并发渲染改进
- 使用
use
函数支持async/await
组件 - 改进
ref
和事件处理性能 - 更智能的 hydration 与服务端渲染支持
✅ 总结建议
- 选择必要依赖,避免臃肿;
- React 19 已增强状态/异步支持,合理用 Redux Toolkit;
- 如果项目偏移动端,推荐使用
antd-mobile
+postcss-pxtorem
+lib-flexible
; - 若偏 PC 端业务,选用
antd
+@reduxjs/toolkit
即可。