React脚手架工具创建项目的详细介绍

水深无声 2023-10-02 20:51 36阅读 0赞

#### 文章目录 ####

*   *  React脚手架工具
     *   *  脚手架工具解析
         *  create-react-app
         *  创建React项目
         *  目录的结构分析
         *  从零编写代码

### React脚手架工具 ###

#### 脚手架工具解析 ####

**如果我们只是开发几个小的demo程序，那么永远不需要考虑一些复杂的问题**:

> 比如目录结构如何组织划分;
> 
> 比如如何管理文件之间的相互依赖;
> 
> 比如如何管理第三方模块的依赖;
> 
> 比如项目发布前如何压缩、打包项目;
> 
> 等等…

**但是现代的前端项目已经越来越复杂了**:

> 不会再是在HTML中引入几个css文件，引入几个编写的js文件或者第三方的js文件这么简单;
> 
> 比如css可能是使用less、sass等预处理器进行编写，我们需要将它们转成普通的css才能被浏览器解析;
> 
> 比如JavaScript代码不再只是编写在几个文件中，而是通过模块化的方式，被组成在**成百上千**个文件中，我们需要通过模块化的技术来管理它们之间的相互依赖;
> 
> 比如项目需要依赖很多的第三方库，如何更好的管理它们(比如管理它们的依赖、版本升级等);

**为了解决上面这些问题，我们需要再去学习一些工具**:

> 比如babel、webpack、gulp，配置它们转换规则、打包依赖、热更新等等一些的内容;
> 
> 脚手架的出现，就是帮助我们解决这一系列问题的;

**编程中提到的脚手架(Scaffold)，其实是一种工具，帮我们可以快速生成项目的工程化结构;**

> 每个项目作出完成的效果不同，但是它们的基本工程化结构是相似的;
> 
> 既然相似，就没有必要每次都从零开始搭建，完全可以使用一些工具，帮助我们生产基本的工程化模板;
> 
> 不同的项目，在这个模板的基础之上进行项目开发或者进行一些配置的简单修改即可;
> 
> 这样也可以间接保证项目的基本机构一致性，方便后期的维护;

**小结: 脚手架让项目从搭建到开发，再到部署，整个流程变得快速和便捷;**

--------------------

#### create-react-app ####

**对于现在比较流行的三大框架都有属于自己的脚手架:**

> Vue的脚手架:@vue/cli
> 
> Angular的脚手架:@angular/cli
> 
> React的脚手架:`create-react-app`

**它们的作用都是帮助我们生成一个通用的目录结构，并且已经将我们所需的工程环境配置好。**

**使用这些脚手架需要依赖什么呢**?

> 目前这些脚手架都是使用node编写的，并且都是基于webpack的;
> 
> 所以我们必须在自己的电脑上安装node环境;

**这里我们主要是学习React，所以我们以React的脚手架工具:create-react-app作为讲解**;

**React脚手架本身需要依赖node，所以我们需要安装node环境**:

> 无论是windows还是Mac OS，都可以通过node官网直接下载;
> 
> [官网地址:][Link 1][https://nodejs.org/en/download/][Link 1]
> 
> 注意:这里推荐大家下载LTS(Long-term support )版本，是长期支持版本，会比较稳定;

**下载后，双击安装即可:**

> 安装过程中，会自动配置环境变量;
> 
> 安装时，会同时帮助我们安装npm管理工具;

#### 创建React项目 ####

**我们需要安装React脚手架工具, 全局安装`npm i create-react-app -g`**

> 安装完成后, 我们就可以通过脚手架来创建React项目了

**创建React项目的命令: `create-react-app 项目名称`**

> 注意:项目名称不能包含大写字母
> 
> 另外还有更多创建项目的方式，可以参考GitHub的readme

**创建完成后，进入对应的目录，就可以将项目跑起来:**

> React早期使用的包管理工具yarn, 输入`yarn start`将项目跑起来;
> 
> 目前React创建的项目是使用的npm包管理工具, 输入`npm run start`可以将项目跑起来

#### 目录的结构分析 ####

![在这里插入图片描述][b23af027476c48aba3b2b0e293d2d1a0.png_pic_center]

**整个目录结构都非常好理解，只是有一个PWA相关的概念**:

> PWA全称Progressive Web App，即渐进式WEB应用;
> 
> 一个 PWA 应用首先是`一个网页`, 可以通过 Web 技术编写出一个网页应用;
> 
> 随后添加上 App Manifest 和 Service Worker 来实现 PWA 的安装和离线等功能;
> 
> 这种Web存在的形式，我们也称之为是 `Web App`;

**PWA解决了哪些问题呢?**

> 可以将PWA的网站像应用程序一样添加至主屏幕，点击主屏幕图标可以实现启动动画以及隐藏地址栏;
> 
> 实现离线缓存功能，即使用户手机没有网络，依然可以使用一些离线功能;
> 
> 实现了消息推送;
> 
> 等等一系列类似于Native App相关的功能;

**更多PWA相关的知识，可以自行去学习更多(*在公司是基本用不到PWA的, 了解即可*)**;

> [链接: ][Link 2] [https://developer.mozilla.org/zh-CN/docs/Web/Progressive\_web\_apps][Link 2]

#### 从零编写代码 ####

**通过脚手架创建完项目，很多人还是会感觉目录结构过于复杂，所以我打算从零带着大家来编写代码。**

**我们先将不需要的文件统统删掉**:

> 将public文件下, 除favicon.ico和index.html之外的文件都删除掉
> 
> src文件夹是我们编写源代码的地方, 默认创建项目在src文件夹中生成的文件全部都是可以删除的,

![在这里插入图片描述][51ff6c607b794ed290a1bc7bb5531178.png_pic_center]

**删除完成我们需要创建一个index.js文件, 因为这是webpack打包的入口文件, 在index.js中开始编写React代码**:

> 我们会发现和写的代码是逻辑是一致的;
> 
> 只是在模块化开发中，我们需要手动的来导入React、ReactDOM，因为它们都是在我们安装的模块中;

import ReactDOM from "react-dom/client"
    
    const root = ReactDOM.createRoot(document.querySelector("#root"))
    root.render(<h2>哈哈哈哈</h2>)

\*\*`root.render`是可以渲染组件的, 我们可以编写一个组件通过render渲染 \*\*

import React from "react"
    import ReactDOM from "react-dom/client"
    
    class App extends React.Component {
        
      constructor() {
        
        super()
        this.state = {
        
          message: "Hello React"
        }
      }
    
      render() {
        
        const {
         message } = this.state
        return (
          <div>
            <h2>{
        message}</h2>
          </div>
        )
      }
    }
    
    const root = ReactDOM.createRoot(document.querySelector("#root"))
    root.render(<App/>)

**如果我们不希望直接在 `root.render` 中编写过多的代码，就可以单独抽取一个组件到`App.js`文件或者`App.jsx`文件**:

// App.js
    
    import React from "react"
    
    class App extends React.Component {
        
      constructor() {
        
        super()
        this.state = {
        
          message: "Hello React"
        }
      }
    
      render() {
        
        const {
         message } = this.state
        return (
          <div>
            <h2>{
        message}</h2>
          </div>
        )
      }
    }
    
    export default App

// index.js
    
    import ReactDOM from "react-dom/client"
    import App from "./App"
    
    
    const root = ReactDOM.createRoot(document.querySelector("#root"))
    root.render(<App/>)

[Link 1]: https://nodejs.org/en/download/
[b23af027476c48aba3b2b0e293d2d1a0.png_pic_center]: https://img-blog.csdnimg.cn/b23af027476c48aba3b2b0e293d2d1a0.png#pic_center
[Link 2]: https://developer.mozilla.org/zh-CN/docs/Web/Progressive_web_apps
[51ff6c607b794ed290a1bc7bb5531178.png_pic_center]: https://img-blog.csdnimg.cn/51ff6c607b794ed290a1bc7bb5531178.png#pic_center