从0到1使用vite搭建react项目保姆级教程（持续更新中）

一、vite创建react项目

要使用Vite创建一个React项目，你需要按照以下步骤操作：

1、确保你已经安装了Node.js（建议使用最新的稳定版本）。

2、 使用npm命令安装Vite CLI工具，再来创建项目

npm create vite@latest my-vite-app 

3、运行上述命令后，按照提示选择"create-react-app"模板创建项目。

4、输入项目名称，例如"my-react-app"。

5、选择需要的选项，例如选择JavaScript或TypeScript作为项目的编程语言。

SWC是JavaScript编译工具比Babel要快，但是在功能和插件生态系统方面Babel更完善

6、等待依赖安装完毕。

以下是一个简单的命令行示例：

npm create vite@latest my-vite-app 
# 选择默认模板 'create-react-app'
# 输入项目名称，例如 'my-react-app'
# 选择一个JavaScript框架，或者TypeScript

7、安装完成后，你可以通过以下命令启动开发服务器：

cd my-react-app
npm install 安装package.json中的依赖包
npm run dev

8、现在，你应该拥有一个使用Vite创建并且配置了React的新项目。

9、vite相关命令

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

二、集成开发需要的各种插件

项目搭建之后，我们就开始安装项目所需要的各种插件了：

1、集成vant的react版本组件库（以此为例）

通过 npm 安装

npm i react-vant -S

安装完成之后我们可以看到package.json中多了 "react-vant": "^3.3.5", 即表示安装完成

如何使用vant 中的组件呢， 官方文档地址https://react-vant.3lang.dev/guide/quickstart

引入即可：

import { Uploader,Toast  } from 'react-vant';

具体组件的详细用法参考官方文档组件即可

2、集成less

npm install less -D

npm install less-loader -D

安装好了之后就可以了

3、集成路由并配置

npm install react-router-dom -S

安装好之后，入口App.tsx

import './App.css'
import * as React from 'react'
import RootRouter from "./router.jsx"
import {BrowserRouter} from 'react-router-dom' 
function App() {
  return (
    <BrowserRouter>
      <RootRouter/>
    </BrowserRouter>
  )
}
export default App

router.jsx页面

import * as React from 'react'
import {Routes,Route} from 'react-router-dom'
import Home from "./pages/index"
import User from './pages/user'
import Created from './pages/Created'
import Complete from './pages/Complete'

function Router() {
  return (
    <Routes>
      <Route path="/" element={<Home />} />
      <Route path="/user" element={<User />} />
      <Route path="/created" element={<Created />} />
      <Route path="/complete" element={<Complete />} />
      </Routes>
  );
}

export default Router;

4、集成redux，状态管理

5、国际化配置

三、react语法

1、基础语法参考文档：React 官方中文文档

2、react进阶 内置Hook

Hook 可以帮助在组件中使用不同的 React 功能。你可以使用内置的 Hook 或使用自定义 Hook。本页列出了 React 中所有内置 Hook

React 内置 Hook -- React 中文文档

示例：useState Hook

import * as React from 'react'
import {useState} from 'react'

function UserPage() {
  const navigateTo  = useNavigate();
  const [account, setAccount] = useState('some-account-value');  
  const [columns, setColumns] = useState([/* ...初始的列数据... */]); 

    return (

        <div></div>
            
        )

}

四、QA：问答

1、类型"JSX.IntrinsicElements"上不存在属性"div"?

react使用ts 内部组件如果是div a标签这种html标签ts会报错

类型"JSX.IntrinsicElements"上不存在属性"div"

这种本来就不是自定义组件的标准html标签怎么取消这种ts报错呢，或者怎么告诉ts这就是标准html标签

解决方案：

配置下tsconfig.json文件

"compilerOptions":{

"jsx": "react",

},

2、提示 useRoutes() may be used only in the context of a ＜Router＞ component.

需要在外面包一层 <BrowserRouter>

3 、vite创建的项目不支持require，会提示require未定义

解决方案：前端有很多工具包是commonjs的写法，只能用require引入，为了vite构建的项目也可以方便的引入commojnjs包，需要把这些工具包转换为es module

（1）安装 vite-plugin-commonjs插件

npm i vite-plugin-commonjs

（2）在vite.config.js中添加该插件，注意commonjs()必须在react()上面，否则不生效，打包的时候也需要配置一下，把require转换一下

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import commonjs from 'vite-plugin-commonjs';

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [commonjs(),react()],
  build: {
	  commonjsOptions: {
	    transformMixedEsModules: true
	  }
  }
})

未完待续，后续react相关问题会长期记录在本博客下~~