Vite搭建React项目的方法步骤

时间:2022-06-01 12:58:39

前言

日常放鸽,火钳刘明

这是一个基于 vite 搭建的 React 的项目,开发体验非常棒。

创建一个 Vite 项目

  1. yarn create @vitejs/app

Vite搭建React项目的方法步骤

如上图,选择了 react-ts 预设模板,如果出现下图一样的工程

Vite搭建React项目的方法步骤

  1. yarn // 安装依赖
  2. yarn dev // 启动开发环境

Vite搭建React项目的方法步骤

打开浏览器输入http://localhost:3000/#/,如上图所示的话。那么恭喜你,你可以正常开发 React 项目了。完结撒花

如果不行的话,直接看 vite 官网,它比我写的详细

改造工程

但上述只是一个基础的 React demo,在实际开发项目中,是远远不够的,需要额外做一些项目配置

目录约定

根据日常的开发习惯,先进行基本的目录约定

  1. ├── dist/ // 默认的 build 输出目录
  2. └── src/ // 源码目录
  3. ├── assets/ // 静态资源目录
  4. ├── config
  5. ├── config.js // 项目内部业务相关基础配置
  6. ├── components/ // 公共组件目录
  7. ├── service/ // 业务请求管理
  8. ├── store/ // 共享 store 管理目录
  9. ├── until/ // 工具函数目录
  10. ├── pages/ // 页面目录
  11. ├── router/ // 路由配置目录
  12. ├── .main.tsx // Vite 依赖主入口
  13. ├── .env // 环境变量配置
  14. ├── vite.config.ts // vite 配置选型,具体可以查看官网 api
  15. └── package.json

配置路由

改造 main.tsx

  1. import React from 'react'
  2. import ReactDOM from 'react-dom'
  3. import { HashRouter, Route, Switch } from 'react-router-dom'
  4. import routerConfig from './router/index'
  5. import './base.less'
  6.  
  7. ReactDOM.render(
  8. <React.StrictMode>
  9. <HashRouter>
  10. <Switch>
  11. {
  12. routerConfig.routes.map((route) => {
  13. return (
  14. <Route key={route.path} {...route} />
  15. )
  16. })
  17. }
  18. </Switch>
  19. </HashRouter>
  20. </React.StrictMode>,
  21. document.getElementById('root')
  22. )

router/index.ts 文件配置

  1. import BlogsList from '@/pages/blogs/index'
  2. import BlogsDetail from '@/pages/blogs/detail'
  3.  
  4. export default {
  5. routes: [
  6. { exact: true, path: '/', component: BlogsList },
  7. { exact: true, path: '/blogs/detail/:article_id', component: BlogsDetail },
  8. ],
  9. }

可以参考上述的配置,把其他的属性也配置进去,比如重定向(redirect)、懒加载等常见路由配置项

另外个人比较倾向通过配置来生成路由,约定式路由总感觉不太方便。

service 管理

所有项目请求都放入 service,建议每个模块都有对应的文件管理,如下所示

  1. import * as information from './information'
  2. import * as base from './base'
  3.  
  4. export {
  5. information,
  6. base
  7. }

这样可以方便请求管理

base.ts 作为业务请求类,可以在这里处理一些业务特殊处理

  1. import { request } from '../until/request'
  2.  
  3. const prefix = '/api'
  4.  
  5. export const getAllInfoGzip = () => {
  6. return request({
  7. url: `${prefix}/apis/random`,
  8. method: 'GET'
  9. })
  10. }

until/request 作为统一引入的请求方法,可以自定义替换成 fetch、axios 等请求库,同时可以在此方法内封装通用拦截逻辑。

  1. import qs from 'qs'
  2. import axios from "axios";
  3.  
  4. interface IRequest {
  5. url: string
  6. params?: SVGForeignObjectElement
  7. query?: object
  8. header?: object
  9. method?: "POST" | "OPTIONS" | "GET" | "HEAD" | "PUT" | "DELETE" | undefined
  10. }
  11.  
  12. interface IResponse {
  13. count: number
  14. errorMsg: string
  15. classify: string
  16. data: any
  17. detail?: any
  18. img?: object
  19. }
  20.  
  21. export const request = ({ url, params, query, header, method = 'POST' }: IRequest): Promise<IResponse> => {
  22. return new Promise((resolve, reject) => {
  23. axios(query ? `${url}/?${qs.stringify(query)}` : url, {
  24. data: params,
  25. headers: header,
  26. method: method,
  27. })
  28. .then(res => {
  29. resolve(res.data)
  30. })
  31. .catch(error => {
  32. reject(error)
  33. })
  34. })
  35. }

具体通用拦截,请参考 axios 配置,或者自己改写即可,需要符合自身的业务需求。

这里使用 axios 构建出来的资源有问题,不要直接使用,请参考之前的请求封装替换成 fetch,如果有同学构建成功的,请留言 = =!

在具体业务开发使用的时候可以按照模块名引入,容易查找对应的接口模块

  1. import { information } from "@/service/index";
  2.  
  3. const { data } = await information.getAllInfoGzip({ id });

这套规则同样可以适用于 store、router、utils 等可以拆开模块的地方,有利于项目维护。

上述是针对项目做了一些业务开发上的配置与约定,各位同学可以根据自己团队中的规定与喜好行修改。

其他配置

这里主要是关于 vite.config.ts 的配置,对项目整体做一些附加配置。

  1. import { defineConfig } from 'vite'
  2. import reactRefresh from '@vitejs/plugin-react-refresh'
  3. import vitePluginImp from 'vite-plugin-imp'
  4.  
  5. export default defineConfig({
  6. plugins: [
  7. reactRefresh(),
  8. vitePluginImp({
  9. libList: [
  10. {
  11. libName: 'antd-mobile',
  12. style(name) {
  13. return `antd-mobile/lib/${name}/style/index.css`
  14. },
  15. },
  16. ]
  17. })
  18. ],
  19. resolve: {
  20. extensions: ['.mjs', '.js', '.ts', '.jsx', '.tsx', '.json'],
  21. alias: {
  22. '@': '/src'
  23. }
  24. },
  25. server: {
  26. proxy: {
  27. // 选项写法
  28. '/api': {
  29. target: 'https://www.xxx.xxx',
  30. changeOrigin: true,
  31. rewrite: (path) => path.replace(/^\/api/, '')
  32. },
  33. }
  34. },
  35. css: {
  36. postcss: {
  37. plugins: [
  38. require('postcss-pxtorem')({ // 把px单位换算成rem单位
  39. rootValue: 32, // 换算基数,默认100,这样的话把根标签的字体规定为1rem为50px,这样就可以从设计稿上量出多少个px直接在代码中写多上px了。
  40. propList: ['*'], //属性的选择器,*表示通用
  41. unitPrecision: 5, // 允许REM单位增长到的十进制数字,小数点后保留的位数。
  42. exclude: /(node_module)/, // 默认false,可以(reg)利用正则表达式排除某些文件夹的方法
  43. })
  44. ]
  45. }
  46. }
  47. })

大体也是一些基本内容:

  • vitePluginImp 是将 antd-mobile 进行按需加载
  • postcss-pxtorem 是配置移动端 px 转换的插件
  • server.proxy 配置项目代理
  • resolve.alias 配置别名,如果需要 vscode 正常识别的话,需要 ts.config 也配置一下
  1. {
  2. "compilerOptions": {
  3. "baseUrl": "./",
  4. "paths": {
  5. "@/*": [
  6. "src/*"
  7. ]
  8. },
  9. }

其中 antd-mobile 可以自行替换成 antd,包括 postcss 也可以根据自己的喜好替换

通过上述的简单改造,此时已经可以进行正常的小项目开发了。完结撒花!

并且已经在用此配置写了一个简单的 H5 项目,后续随着项目的迭代会逐步完善一下模板。

到此这篇关于Vite搭建React项目的方法步骤的文章就介绍到这了,更多相关Vite搭建React项目内容请搜索服务器之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持服务器之家!

原文链接:https://juejin.cn/post/6948103204060004359