基于vite搭建React项目

背景

最近要做一个新项目,打算用 vite 来搭建项目。毕竟最近 vite 很火,vite 也可以说代表着未来,可以学习一下。

本文主要记录整个项目的搭建过程。

脚手架

直接用 vite 官方文档 提供的命令来初始化整个项目,框架选择 React ,加上 ts 类型提示。整个过程没有踩到坑,很顺畅。

组件库

组件库使用字节开源的 arco-design。原因是以前一直用的 arco-desigin,对它比较熟悉 (提过PR),而且 oncall 也能及时响应。

css

tailwind,推荐使用,没有用过的一定要试一下!!

tailwind css 是现代工程化框架里把原子css做到极致的css框架,它将大部分css属性封装成语义化的类,使用者的关注点从写css到使用tailwind类名,极大的减少了代码量。

优点:

  1. 降低为类命名的精力——如何为div起一个语义化的类名是开发者经常遇到的问题,使用tailwind之后,大部分情况下都能直接使用 tailwind 类名而无需开发者关注如何起名,这对大部分开发者都是喜闻乐见的事。

  2. 大大减少CSS代码量。

  3. 样式跟着元素走,方便删除。tailwind是内联在元素上,元素如果需要删除,css也会跟着删除。

缺点:原子类太多,需要花费时间去记忆和查阅官方文档。

如果你是VSCode使用者,VSCode有tailwind插件提示。

image.png

请求

请求使用 fetch,使用 React hooks 库 swr 来管理请求的状态,包括返回的数据,error状态等。

举个🌰:

import useSWR from 'swr'

function Profile() {
  const { data, error } = useSWR('/api/user', fetcher)

  if (error) return <div>failed to load</div>
  if (!data) return <div>loading...</div>
  return <div>hello {data.name}!</div>
}

swr 对接口状态进行了封装,在内部维护了数据的状态,使开发者不在需要去自行维护这些状态。
当然,swr 的能力不止这些,还有像条件请求、自动重新请求、缓存等功能。

状态管理

新项目状态管理舍弃了 redux,原因是太繁琐,不好用。

接入了轻量级的 unstated-next ,使用很简单,源码也才40行,很容易理解原理。

项目目录

-src
    -assets
    -components
    -constant
    -hooks
    -pages
    -services
    -routes.ts
    -App.tsx
    -main.css
    -main.tsx

路由配置

新增 routes.ts 文件,所有页面的路由都集中在 routes.ts 配置。

import YourComponent from '@pages/YourComponent'

const routesConfig = [
  {
    path: '/',
    component: YourComponent
  },
]

export default routesConfig

把页面布局以及路由都集中到 App.tsx 中:

import { BrowserRouter, Route, Routes } from 'react-router-dom';
import routerConfig from '@/routes'
import Layout from '@/components/Layout'
import Header from '@/components/Header';
import { Notification } from '@arco-design/web-react'
import userContainer, { useUser } from '@/hooks/useUser';
import { Spin } from '@arco-design/web-react'
import './main.css';
import "@arco-design/web-react/dist/css/arco.css";

function App() {
  const { isLoading, isError } = useUser();
  if (isLoading) {
    return <Spin dot />
  }

  if (isError) {
    Notification.error({
      title: '请重新登录',
      content: '正在重新加载',
    })
    return null;
  }
  
  return (
    <BrowserRouter basename='mlbb'>
      <userContainer.Provider>
        <Header />
        <div className="flex">
          <Layout />
          <div className="bg-slate-200 flex-1 p-5 h-screen overflow-hidden">
            <Routes>
              {
                routerConfig.map((route) => {
                  const { path, component: Component} = route
                  return (
                    <Route key={route.path} path={path} element={<Component />} />
                  )
                })
              }
              </Routes>
            </div>
          </div>
        </userContainer.Provider>
    </BrowserRouter>
  )
}

export default App;

App.tsx 里面,可以判断当前用户是否登录,如果没有登录则提示登录及展示登录页。

由于笔者是在 sso 登录,已经在接口层面做了判断,如果没有登录会直接在接口层打开 sso 登录页。

整个页面的布局如下:

image.png

渲染

main.tsx 渲染 App

import ReactDOM from 'react-dom/client'
import App from './App';

ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(
 <App />
)

问题

整个流程还是比较顺畅的,唯一遇到的问题是在 接入 sso 之后,如果本地启动还是用 localhost去访问,则 sso 无法访问,这就需要把页面通过域名来访问,然后代理到本地。

vite 默认是无法通过ip去访问的,需要在 vite.config.ts 配置 host

image.png

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 159,219评论 4 362
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 67,363评论 1 293
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 108,933评论 0 243
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 44,020评论 0 206
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,400评论 3 287
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,640评论 1 219
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,896评论 2 313
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,597评论 0 199
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,327评论 1 244
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,581评论 2 246
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 32,072评论 1 261
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,399评论 2 253
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 33,054评论 3 236
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,083评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,849评论 0 195
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,672评论 2 274
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,585评论 2 270

推荐阅读更多精彩内容