【React】从零开始搭建 react 项目(初始化+路由)

创建 React 项目

创建项目的方式:create-react-app 项目名称

如果没有安装 react 脚手架,请先安装

shell 复制代码
npm isntall create-react-app -g

安装成功后,开始配置项目

配置项目的 icon 和标题

配置 jsconfig.json

目的:用于配置 JavaScript 或 TypeScript 项目的根目录和其他一些选项,以帮助编辑器(如 VS Code)更好地理解项目的结构和提供智能提示

更多可以查看【React 】react 创建项目配置 jsconfig.json 的作用

js 复制代码
{
  "compilerOptions": {
    "target": "es5",
    "module": "esnext",
    "baseUrl": "./",
    "moduleResolution": "node",
    "paths": {
      "@/*": [
        "src/*"
      ]
    },
    "jsx": "preserve",
    "lib": [
      "esnext",
      "dom",
      "dom.iterable",
      "scripthost"
    ]
  }
}

配置 craco.config.js

CRACO(Create React App Configuration Override)是一个易于理解且强大的工具,它提供了一种简单的方法来覆盖和自定义 Create React App 的配置,而无需执行"eject"操作。这种方法让你能够保留 Create React App 提供的所有优势,同时还能根据需要修改配置。

目的:用于配置 webpack 和一些 react 插件的配置

shell 复制代码
npm i -D @craco/craco craco-less

安装 craco-less 主要是为了使用 less

js 复制代码
const path = require('path')
const CracoLessPlugin = require('craco-less');

const resolve = pathname => path.resolve(__dirname, pathname)

module.exports = {
  // less
  plugins: [
    {
      plugin: CracoLessPlugin
    },
  ],
  // webpack
  webpack: {
    alias: {
      "@": resolve("src"),
      "components": resolve("src/components"),
      "utils": resolve("src/utils")
    }
  }
}

接下来,你需要更新 package.json 中的 scripts 部分,将原本调用 react-scripts 的命令替换为使用 CRACO CLI

json 复制代码
"scripts": {
  "start": "craco start",
  "build": "craco build",
  "test": "craco test"
}

项目目录结构划分

清理 react 脚手架默认创建的文件,重新创建符合个人项目开发的文件夹结构(参考如下)

CSS 样式重置

安装 normalize.css

shell 复制代码
npm install normalize.css

导入

自己编写其他的样式重置 css

css 复制代码
body, button, dd, dl, dt, form, h1, h2, h3, h4, h5, h6, hr, input, li, ol, p, pre, td, textarea, th, ul {
  padding: 0;
  margin: 0;
}

a {
  text-decoration: none;
}


img {
  vertical-align: top;
}

ul, li {
  list-style: none;
}

Router 配置

shell 复制代码
npm install react-router-dom

src\router\index.js

js 复制代码
import React from "react"
import { Navigate } from "react-router-dom"

// 懒加载
const Home = React.lazy(() => import("@/views/home"))
const Entire = React.lazy(() => import("@/views/entire"))
const Detail = React.lazy(() => import("@/views/detail"))

const routes = [
  {
    path: "/",
    element: <Navigate to="/home"/>
  },
  {
    path: "/home",
    element: <Home/>
  },
  {
    path: "/entire",
    element: <Entire/>
  },
  {
    path: "/detail",
    element: <Detail/>
  }
]

export default routes

App.jsx

js 复制代码
import { memo } from 'react';
import routes from './router';
import { useRoutes } from 'react-router-dom';

// memo: 组件的渲染结果,只会在 props 改变时才会重新渲染
const App = memo(() => {
  return (
    <div className="app">
      <div className="header">header</div>
      <div className="page">{useRoutes(routes)}</div>
      <div className="footer">footer</div>
    </div>
  );
});

export default App;

index.js

js 复制代码
import React, { Suspense } from 'react' // Suspense 解决路由懒加载问题
import ReactDOM from 'react-dom/client'
import { HashRouter } from 'react-router-dom'

import App from '@/App'
import 'normalize.css'
import './assets/css/index.less'


const root = ReactDOM.createRoot(document.getElementById('root'))
root.render(
  <Suspense fallback='loading'>
    <HashRouter>
      <App />
    </HashRouter>
  </Suspense>,
)
相关推荐
2026几秒前
11. vite打包优化
前端·javascript·vite
拾光拾趣录5 分钟前
组件封装的⼀些基本准则
前端·前端工程化
CAD老兵6 分钟前
TypeScript 中如何转换两个具有相同值的枚举类型?
前端
1024小神10 分钟前
Cocos游戏开发中,检测两个物体碰撞,并实现物理反弹逻辑
前端·javascript
拾光拾趣录12 分钟前
Vue Router 执行顺序
前端·vue.js·vue-router
前端权13 分钟前
Vue3 多行文本溢出隐藏与展开收起功能实现总结
前端·vue.js
用户38022585982413 分钟前
vue3源码解析:调度器
前端·vue.js
Dolphin_海豚36 分钟前
electron windows 无边框窗口最大化时的隐藏边框问题
前端·electron·api
梦想CAD控件39 分钟前
WEB CAD与Mapbox结合实现在线地图和CAD编辑(CGCS2000)
前端·javascript·vue.js