react移动端项目构建，react+react_vant+vite+axios+redux+sass

react：https://react.nodejs.cn/reference/react/hooks
vant：https://vant-contrib.gitee.io/vant/#/zh-CN
axios：https://www.axios-http.cn/docs/api_intro
vite：https://vitejs.cn/
redux：https://cn.redux.js.org/index.html
redux-persist：https://github.com/rt2zz/redux-persist
sass：https://blog.csdn.net/randy521520/article/details/131242242
前言：
本文紧张解说react V18移动端项目构建，在构建项目前请确保已安装node、yarn工具，node版本18+，此项目构建紧张集成：axios、pinia、vant、sass、vite和react V18，其中还会介绍到如何跨页面通报数据、国际化配置、rem适配等功能
本文解说的功能代码只是扼要说明，完备代码可点击以下链接下载，下载后请先看README.md文档说明，已踩过大部门坑：
react PC端项目构建TS，react@18.2.0+antd+vite+axios+redux+sass+ts 完备版代码下载：
https://download.csdn.net/download/randy521520/88922625
react PC端项目构建，react@18.2.0+antd+vite+axios+redux+sass完备版代码下载：
https://download.csdn.net/download/randy521520/88922569
react移动端项目构建TS，react@18.2.0+react-vant+vite+axios+redux+sass+ts完备版代码下载：
https://download.csdn.net/download/randy521520/88917557
react移动端项目构建，react@18.2.0+react-vant+vite+axios+redux+sass完备版代码下载：
https://download.csdn.net/download/randy521520/88917543
一、初始化项目

1.cmd打开终端工具，运行：yarn create vite

2.输入项目名称，键盘方向键选择React

3.键盘方向键选择JavaScript或JavaScript+SWC，SWC是JavaScript编译工具比Babel要快，但是在功能和插件生态系统方面Babel更完满；这里选择JavaScript

4.项目创建乐成

5.开辟者工具打开项目，打开开辟者工具的终端，运行yarn install，安装package.json中的依赖包

6.修改package.json脚本中的dev为 vite --open，运行yarn dev，就会启动项目并在浏览器中自动打开，不加–open不会在浏览器中自动打开，项目初始化乐成

7.vite相关命令

1. vite [root]：启动开发服务器，可以指定一个根目录（可选）。
2. build [root]：构建生产环境的应用程序，可以指定一个根目录（可选）。
3. optimize [root]：预打包依赖项，用于优化构建性能。
4. preview [root]：本地预览生产环境的构建结果，可以指定一个根目录（可选）。
5. --open：启动开发服务器后自动打开默认浏览器并访问应用程序
6. --cors：启用 CORS（跨域资源共享）。
7. --strictPort：如果指定的端口已被占用，则退出。
8. --force：强制优化器忽略缓存并重新打包。
9. -c, --config <file>：使用指定的配置文件。
10. --base <path>：设置公共基础路径，默认为 /。
11. -l, --logLevel <level>：设置日志级别，可选值为 info、warn、error、silent。
12. --clearScreen：允许或禁用日志时的清屏操作。
13. -d, --debug [feat]：显示调试日志，可选参数为特定功能的名称。
14. -f, --filter <filter>：过滤调试日志的输出。
15. -m, --mode <mode>：设置环境模式。
16. -h, --help：显示帮助信息。
17. -v, --version：显示版本号。

复制代码

二、集成vant

1.终端运行：yarn add react-vant，安装vant

2.新建pages>home>home.jsx，在home.jsx中使用Buton组件，并在vite.config.js配置路径别名

3.修改App.jsx，使用Home

4.react-vant 支持基于 Tree Shaking 的按需加载，大部门的构建工具（比方 webpack 4+ 和 rollup）都支持 Tree Shaking，所以绝大多数情况下无需做额外的配置
三、集成sass

sass是css预处理器，可以声明变量、函数、嵌套等功能，可以减少重复的代码，使得样式表的结构更清晰、更易读。sass还内置了许多函数，处理颜色、数值等，也可以自定义函数扩展sass，还可以通过Mixin定义一组样式，并在需要的地方进行引用，可以避免重复的样式代码，而且方便进行样式的修改和维护
1.终端运行：yarn add sass -D，安装sass

2. 在assets中新建scss>global.scss、scss>globalMixin.scss、scss>globalVar.scss、scss>iframe.scss，global.scss用于通用的样式、globalMixin.scss用于Mixin通用的样式、globalVar.scss用于全局变量、iframe.scss用于导出scss文件，修改vite.config.js，将iframe.scss文件引入到项目中

3.新建pages>home>home.module.scss，修改home.jsx，div样式使用了scss变量、Mixin函数、scss通用样式已生效

四、路由配置

1.终端运行：yarn add react-router-dom，安装react-router-dom

2.在src新建router.jsx

3.修改App.jsx、main.jsx

五、ConfigProvider定制化主题

1.在src下新建theme.js，之所以接纳theme.js配置主题，是为了写内联样式时可以使用一样的主题配置

2.修改app.jsx，通过theme.js配置主题，有个缺点就是无法和globalVar.scss变量中的值保持统一，如果需要同一个根本变量，就要写两编，就像示例中globalVar.scss已配置赤色值，但是要改变vant中button的背景色就要重新配置

3.办理globalVar.scss的sass变量无法和theme.js保持统一的标题，可通过在vite.config.js读取globalVar.scss文件，再配置全局变量

4.新建hooks>useCommon.js，并在vite.config.js中配置别名

5.修改globalVar.scss

6.修改App.jsx，重新运行yarn dev；这样配置有个缺点：import.meta.env是构建得时间生成得，项目运行后无法更改，修改globalVar.scss原有的值是不会变的，需要重新运行项目；可通过自定义插件办理该标题：插件配置configureServer，通过server.ws.on、server.ws.send把已改变的globalVar.scss后的值发送到客户端，客户端在useEnv中通过import.meta.hot.on继承值；可通过自定义插件办理该标题：插件配置configureServer，通过server.ws.on、server.ws.send把已改变的globalVar.scss后的值发送到客户端，客户端在useEnv中通过import.meta.hot.on继承值

六、集成postcss，适配

1.终端运行：yarn add postcss-px-to-viewport-8-plugin -D，安装postcss-px-to-viewport-8-plugin

2.在根目录上新建postcss.config.js，重新运行项目，会发现之前div中的px已转换为vw，vant框架内部定义的变量也转为vw

3.只使用postcss.config.js是无法转换内联样式中的像素，可以自己写个hooks转换

4.修改vite.config.js配置postcssConfig全局变量

5.在hooks下新建usePxTransform.js

6.修改home.jsx使用usePxTransform

七、集成redux，状态管理

1.终端运行：yarn add @reduxjs/toolkit react-redux redux-persist ，安装@reduxjs/toolkit、react-redux、redux-persist

2.在src下新建store>redux.js、store>persistConfig.js、store>demoStore.js，在vite.config.js配置路径别

3.修改App.jsx

4.修改home.jsx，使用demoStore

八、国际化配置

1.终端运行：yarn add i18next react-i18next，安装i18next、react-i18next

2.在src下新建common>enum.js，enum.js公共枚举文件，并在vite.config.js中配置路径别名

3.在src下新建lang>en_us.js、lang>zh_cn.js、lang>lang.js，用于创建国际化，并在main.js中使用该配置，在vite.config.js中配置路径别名，把语言配置存入localStorage是为了包管语言改变之后，刷新页面之后也可以使用之前改变后的语言

4.修改home.jsx

九、创建page.jsx组件作为项目标页面组件

1.终端运行：yarn add prop-types，安装prop-types

2.新建components>common>slot>Slot.jsx、components>common>slot>SlotContext.jsx、components>common>slot>SlotProvider.jsx、components>common>slot>SlotTemplate.jsx并把src/components在vite.config.js中配置路径别名

3.在components下新建layout>page>age.jsx

4.删除index.css，把App.css修改为App.scss，修改App.jsx

5.修改home.jsx

十、集成字体图标

1.字体图标集成以阿里icon为例，访问：https://www.iconfont.cn/ 图标库，搜索返回，任选一个图标加入购物车

2.去购物车中，选择下载代码

3.在assets下新建font文件，把下载好的字体图标解压到该文件，然后在App.scss中引入iconfont.css

4.在components下新建commpon>icon>Icon.jsx

5.修改Page.jsx，增长返回图标

十一、集成axios

1.终端运行：yarn add axios，安装axios

2.在common下新增requests.js

3.修改home.jsx

十二、开辟环境配置

1.在根目录下新建.env.development、.env.production

2.修改package.json中的脚本命令

3.修改useCommon.js中的useEnv

4.重新运行yarn dev

十三、路由跳转

1.修改Page.jsx、Icon.jsx，给Page.jsx增长返回事件，新建icon.modue.scss

2.在pages下新建三个页面：list.jsx、add.jsx、detail.jsx，分别为列表页、添加页、详情页，并配置路由

3.路由跳转home>list>add >detail 或 home>list>detail，下图中演示了两种路由跳转传参的方式，第一种params传参：需要提前在路由上配置相关参数，跳转成之后url上会显示参数，页面刷新之后不会丢失，通过useParams获取参数；第二种state传参，跳转成之后url上不会显示参数，页面刷新之后不会丢失，通过useLocation获取参数；不过返回页面时不能向返回页面通报参数，不需要该功能的可以忽略下面教程

十四、路由封装

在刚才的路由跳转中，分析了一些路由跳转的弱势，而且路由的封装可以完满Page.jsx的返回功能。可以参考微信小步伐的路由跳转功能，通过消息事件发布和订阅（事件发射器）来封装路由，再由状态管理器储存路由。事件发射器有三个根本的功能：注册事件、移除事件、触发事件
1.终端运行：yarn add react-activation，安装react-activation，路由缓存

2.修改router.jsx、main.jsx，使用路由缓存

3.在根目录下新建tabBar.js，可使用该js扩展Page.tsx组件增长tabbar功能

4.新建utils>commonUtil.js，并配置路由别名

5.在stroe下新建routerStore.js，并在redux.js配置routerStore

6.在hooks下新建useRouter.js

7.修改Page.jsx

8.修改home.jsx、list.jsx、add.jsx、detail.jsx路由跳转，list中的useEffect、useActivate可以一起封装成hook

9.页面效果

十五、结语

本文只是大致讲了下react移动端项目搭建，详细的细节还是需要根据自己项目标需要进行调解。路由只封装了navigateTo、navigateBack，可以根据微信小步伐路由api的逻辑https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html 封装switchTab、reLaunch、redirectTo，如果有更好的方法可以忽略该路由封装，个人觉得小步伐路由做的挺好。路径别名可配可不配，根据自己喜好就行

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。