Vite搭建React項目的方法步驟

前言

日常放鴿,火鉗劉明

這是一個基於 vite 搭建的 React 的項目,開發體驗非常棒。

創建一個 Vite 項目

yarn create @vitejs/app

如上圖,選擇瞭 react-ts 預設模板,如果出現下圖一樣的工程

yarn   // 安裝依賴
yarn dev  // 啟動開發環境

打開瀏覽器輸入http://localhost:3000/#/,如上圖所示的話。那麼恭喜你,你可以正常開發 React 項目瞭。完結撒花

如果不行的話,直接看 vite 官網,它比我寫的詳細

改造工程

但上述隻是一個基礎的 React demo,在實際開發項目中,是遠遠不夠的,需要額外做一些項目配置

目錄約定

根據日常的開發習慣,先進行基本的目錄約定

├── dist/       // 默認的 build 輸出目錄
└── src/       // 源碼目錄
 ├── assets/     // 靜態資源目錄
 ├── config      
  ├── config.js    // 項目內部業務相關基礎配置
 ├── components/    // 公共組件目錄
 ├── service/     // 業務請求管理
 ├── store/      // 共享 store 管理目錄
 ├── until/      // 工具函數目錄
 ├── pages/      // 頁面目錄
 ├── router/     // 路由配置目錄
├── .main.tsx      // Vite 依賴主入口
├── .env       // 環境變量配置
├── vite.config.ts     // vite 配置選型,具體可以查看官網 api
└── package.json

配置路由

改造 main.tsx

import React from 'react'
import ReactDOM from 'react-dom'
import { HashRouter, Route, Switch } from 'react-router-dom'
import routerConfig from './router/index'
import './base.less'

ReactDOM.render(
 <React.StrictMode>
 <HashRouter>
  <Switch>
  {
   routerConfig.routes.map((route) => {
   return (
    <Route key={route.path} {...route} />
   )
   })
  }
  </Switch>
 </HashRouter>
 </React.StrictMode>,
 document.getElementById('root')
)

router/index.ts 文件配置

import BlogsList from '@/pages/blogs/index'
import BlogsDetail from '@/pages/blogs/detail'

export default {
 routes: [
 { exact: true, path: '/', component: BlogsList },
 { exact: true, path: '/blogs/detail/:article_id', component: BlogsDetail },
 ],
}

可以參考上述的配置,把其他的屬性也配置進去,比如重定向(redirect)、懶加載等常見路由配置項

另外個人比較傾向通過配置來生成路由,約定式路由總感覺不太方便。

service 管理

所有項目請求都放入 service,建議每個模塊都有對應的文件管理,如下所示

import * as information from './information'
import * as base from './base'

export {
 information,
 base
}

這樣可以方便請求管理

base.ts 作為業務請求類,可以在這裡處理一些業務特殊處理

import { request } from '../until/request'

const prefix = '/api'

export const getAllInfoGzip = () => {
 return request({
 url: `${prefix}/apis/random`,
 method: 'GET'
 })
}

until/request 作為統一引入的請求方法,可以自定義替換成 fetch、axios 等請求庫,同時可以在此方法內封裝通用攔截邏輯。

import qs from 'qs'
import axios from "axios";

interface IRequest {
 url: string
 params?: SVGForeignObjectElement
 query?: object
 header?: object
 method?: "POST" | "OPTIONS" | "GET" | "HEAD" | "PUT" | "DELETE" | undefined
}

interface IResponse {
 count: number
 errorMsg: string
 classify: string
 data: any
 detail?: any
 img?: object
}

export const request = ({ url, params, query, header, method = 'POST' }: IRequest): Promise<IResponse> => {
 return new Promise((resolve, reject) => {
  axios(query ? `${url}/?${qs.stringify(query)}` : url, {
   data: params,
   headers: header,
   method: method,
  })
   .then(res => {
    resolve(res.data)
   })
   .catch(error => {
    reject(error)
   })
 })
}

具體通用攔截,請參考 axios 配置,或者自己改寫即可,需要符合自身的業務需求。

這裡使用 axios 構建出來的資源有問題,不要直接使用,請參考之前的請求封裝替換成 fetch,如果有同學構建成功的,請留言 = =!

在具體業務開發使用的時候可以按照模塊名引入,容易查找對應的接口模塊

import { information } from "@/service/index";

const { data } = await information.getAllInfoGzip({ id });

這套規則同樣可以適用於 store、router、utils 等可以拆開模塊的地方,有利於項目維護。

上述是針對項目做瞭一些業務開發上的配置與約定,各位同學可以根據自己團隊中的規定與喜好行修改。

其他配置

這裡主要是關於 vite.config.ts 的配置,對項目整體做一些附加配置。

import { defineConfig } from 'vite'
import reactRefresh from '@vitejs/plugin-react-refresh'
import vitePluginImp from 'vite-plugin-imp'

export default defineConfig({
 plugins: [
 reactRefresh(),
 vitePluginImp({
  libList: [
  {
   libName: 'antd-mobile',
   style(name) {
   return `antd-mobile/lib/${name}/style/index.css`
   },
  },
  ]
 })
 ],
 resolve: {
 extensions: ['.mjs', '.js', '.ts', '.jsx', '.tsx', '.json'],
 alias: {
  '@': '/src'
 }
 },
 server: {
 proxy: {
  // 選項寫法
  '/api': {
  target: 'https://www.xxx.xxx',
  changeOrigin: true,
  rewrite: (path) => path.replace(/^\/api/, '')
  },
 }
 },
 css: {
 postcss: {
  plugins: [
  require('postcss-pxtorem')({ // 把px單位換算成rem單位
   rootValue: 32, // 換算基數,默認100,這樣的話把根標簽的字體規定為1rem為50px,這樣就可以從設計稿上量出多少個px直接在代碼中寫多上px瞭。
   propList: ['*'], //屬性的選擇器,*表示通用
   unitPrecision: 5, // 允許REM單位增長到的十進制數字,小數點後保留的位數。
   exclude: /(node_module)/, // 默認false,可以(reg)利用正則表達式排除某些文件夾的方法
  })
  ]
 }
 }
})

大體也是一些基本內容:

  • vitePluginImp 是將 antd-mobile 進行按需加載
  • postcss-pxtorem 是配置移動端 px 轉換的插件
  • server.proxy 配置項目代理
  • resolve.alias 配置別名,如果需要 vscode 正常識別的話,需要 ts.config 也配置一下
{
 "compilerOptions": {
 "baseUrl": "./",
 "paths": {
  "@/*": [
  "src/*"
  ]
 },
}

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

通過上述的簡單改造,此時已經可以進行正常的小項目開發瞭。完結撒花!

並且已經在用此配置寫瞭一個簡單的 H5 項目,後續隨著項目的迭代會逐步完善一下模板。

到此這篇關於Vite搭建React項目的方法步驟的文章就介紹到這瞭,更多相關Vite搭建React項目內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀:

    None Found