❤ React18 环境搭建项目与运行（地址已经放Gitee开源）

❤ React项目搭建与运行

环境介绍

node v20.11.0
react 18.2
react-dom  18.2.0

一、React环境搭建

第一种普通cra搭建

1、检查本地环境

node版本 18.17.0

检查node和npm环境
node -v
npm -v

2、安装yarn

npm install -g yarn
yarn --version

3、创建一个新的React项目

npx create-react-app ltbreact

4、进入并运行项目

// 进入项目
cd my_react
// 启动项目
yarn start项目启动成功，在浏览器 输入 http://localhost:3000/ 即可访问react

5、尝试打包

yarn build打包完成以后能在我们项目里面看到一个包

6、下载插件(安装xxx 插件 )

yarn add 插件名称

二、第二种方式vite搭建

1、检查本地环境

node版本 18.17.0
检查node和npm环境
node -v
npm -v

2、安装yarn

npm install -g yarn
yarn --version

3、使用vite创建一个新的React项目

npm create vite@latest 第一种版本yarn create vite ltbreact --template react-ts  //node大于20.0.0 才可以使用yarn create vite ltbreact --template react-js 

4、进入并运行项目

// 进入项目
cd my_react

//安装依赖
yarn

// 启动项目
yarn start (之前的)
yarn dev项目启动成功，在浏览器 输入 ​​ http://localhost:​​5173/​ 即可访问react

5、尝试打包

yarn build打包完成以后能在我们项目里面看到一个包

6、下载插件(安装xxx 插件 )

yarn add 插件名称

三、项目信息配置

1、项目目录

打开Vite构建的项目，项目的目录结构如下：

.
├── index.html
├── package.json
├── src
│   ├── App.css
│   ├── App.tsx
│   ├── favicon.svg
│   ├── index.css
│   ├── logo.svg
│   ├── main.tsx
│   └── vite-env.d.ts
├── tsconfig.json
└── vite.config.js

2、配置resolve.alias 文件导入路径别名

简单介绍一下：
resolve.alias 配置项通过别名来把原导入路径映射成一个新的导入路径。例如使用以下配置：

在项目的 vite.config.ts 之中配置：

默认跟文件为显示src的目录
默认跟组件目录为

// vite.config.ts
import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import path from 'path';// https://vitejs.dev/config/
export default defineConfig({plugins: [react()],resolve: {alias: {'@': path.resolve(__dirname, './src')}}
})

虽然配置好了@但是输入@没有提示，找到tsconfig.json

配置 tsconfig.json

// tsconfig.json
{"compilerOptions": {"paths": {"@/*": ["./src/*"],}}
}

配置 extensions ，省略文件路径的后缀名

3、添加请求方式axios

（1）安装axios并封装请求

安装axios并封装请求
yarn add axios在src下的utils工具类里面新建request.js文件封装axios请求```bash
import axios from 'axios'
const service = axios.create({baseURL: '/接口前缀', //import.meta.env.VITE_BASE_URLheaders: { 'Content-Type': 'application/json;charset=utf-8', },timeout: 5000,
})
export default service;

（2）写接口文件

在src下的api接口类里面新建common.js文件放接口请求
common.js 里面

import request from '@/utils/request.js'// 获取网站信息
export function getqueryWebInfo(params) {return request({url: '/你的接口地址',method: 'get',params})
}

（3）配置接口统一代理地址和相关信息

在vite.config.ts 里面封装接口同意请求的前缀并且配置接口代理

import { defineConfig } from 'vite'
import react from '@vitejs/plugin-react'
import path from 'path';
// https://vitejs.dev/config/
export default defineConfig({plugins: [react()],server: {host: true, //host设置为true才可以使用network的形式，以ip访问项目port: 8808, // 端口号https: false,open: false, //  true 自动打开浏览器自动打开浏览器cors: true, // 跨域设置允许// strictPort: true,  // 如果端口已占用直接退出proxy: {'/你的接口前缀': {target: '你的接口地址/', //线上版本changeOrigin: true,rewrite: (path) => path.replace(/^\/edu-admin/, '/edu-admin')},},}, resolve: {alias: {'@components': '/src/components','@': path.resolve(__dirname, './src')}}
})

请求接口成功

4、集成 react-router 路由

安装

yarn add react-router-dom

这里使用的版本是 "react-router-dom": "^6.21.2"

react router dom v6 支持配置路由 useRoutes（hook）实现

main.ts

使用React Router

需要注意的

react-router-dom从V5升级到V6后，有些使用做了一些改变；
(1) Switch 重命名为 Routes

// v5
<Switch><Route exact path="/"><Home /></Route><Route path="/profile"><Profile /></Route>
</Switch>// v6
<Routes><Route path="/" element={<Home />} /><Route path="profile/*" element={<Profile />} />
</Routes>

(2) Route 的新特性变更 ,component/render被element替代

import Profile from './Profile';// v5
<Route path=":userId" component={Profile} />
<Routepath=":userId"render={routeProps => (<Profile routeProps={routeProps} animate={true} />)}
/>// v6
<Route path=":userId" element={<Profile />} />
<Route path=":userId" element={<Profile animate={true} />} />

(3) 嵌套路由变得更简单

Route children 已更改为接受子路由。
比Route exact 和 Route strict更简单的匹配规则。
Route path 路径层次更清晰。

更多在后续文章React Router v5和React Router v6文章中

Router可以理解为路由器，分为BrowserRouter或HashRouter两个组件

（1）BrowserRouter创建的URL形式
http://xxx.com/some/path

（2）HashRouter创建的URL形式
http://xxx.com/#/some/path

React Router路由配置

配置App.js

（1）导入路由
import { BrowserRouter as Router, Switch, Route } from 'react-router-dom';(2) 导入登录组件和主页组件
import Login from './Login'; // 导入登录组件
import Home from './Home'; // 导入主页组件（3）借助Routes 配置路由 (已更改为Routes ：具体原因可以看主页react错误分析篇章)<Router><Switch><Route exact path="/" component={Home} /> {/* 主页路径 */}<Route path="/login" component={Login} /> {/* 登录页路径 */}</Switch>
</Router>//更改后
import React from 'react';
import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
import Login from '@/views/main/Login'; // 导入登录组件
import Home from '@/views/main/Home'; // 导入主页组件
function App() {return (<Router><Routes><Route path="/" element={<Home />} /> {/* 主页路径 */}<Route path="/login" element={<Login />} /> {/* 登录页路径 */}</Routes></Router>);
}export default App;

5、搭建主页面home

Home.jsx里面

import React from 'react';
import { Link } from 'react-router-dom';
const Home = () => {return (<div><h1>主页</h1><Link to="/login"><button>点击登录</button></Link></div>);
};export default Home;

搭建效果

6、搭建登录页面Login

Login.jsx里面

console.log('我是登录界面');
import React from 'react';
const Login = () => {return <h2>登录页面</h2>;
};export default Login;

搭建效果

到此，我们第一阶段项目的运行和基础搭建完成，路由也能正常访问和请求接口了

第二篇章【❤ React18 环境搭建项目与运行 （2）】