React--》超详细教程——React脚手架的搭建与使用
目录
React脚手架是开发现代Web应用的必备,其充分利用Webpack、Babel、ESlint等工具辅助项目的开发,当然这些工具也无需手动配置即可使用,脚手架的意义更多的是关注的是业务而不是工具的配置;项目的整体技术架构为:react + webpack + es6 + eslint。使用脚手架开发项目的特点:模块化、组件化、工程化。
React脚手架的创建
创建React脚手架有很多,React官方推荐我们使用Create React App,当然还有以下常见脚手架
Next.js:如果你是在用 Node.js 构建服务端渲染的网站
Gatsby:如果你是在构建面向内容的静态网站
nwb:用于React应用程序、库和其他web npm模块的工具包
razzle:创建没有配置的服务器呈现的通用JavaScript应用程序
Neutrino:创建和构建零初始配置的现代JavaScript应用程序
Umijs:蚂蚁金服脚手架
Icejs:阿里巴巴脚手架
有些大厂会使用他们自身的脚手架,搭建他们公司的项目会更快,在这祝愿大家早日入驻大厂学习更多的React脚手架的知识吧,这里我就以官方推荐的脚手架讲解:
全局安装创建
新建终端输入以下命令进行全局安装:
npm install -g create-react-app
创建完成后可能会出现以下问题,tar@2.2.2:此版本的tar不再受支持,将不会收到安全更新,请尽快升级。 这只是一个警告,这不是错误。 安装程序只是让您意识到 tar 包已过时,就是说你不管它也ok。
那么如何解决这个问题呢,网上一大堆都在说直接 npm i bar ,但貌似并没有实际效果。国外某小伙也遇到这个问题,如下:
ok,看看别人是这么针对这个问题进行回复的,别人是这样说的,只要你node和npm满足相应的版本后,使用如下命令进行安装即可,用npx进行安装也是官方推荐的,这个后面在说。
这个问题可能是create-react-app经常更新或者其它原因导致的,我们忽略这个警告,接着往下:
切换想创建项目的目录,在终端输入如下命令:
create-react-app 项目名称
npm start:执行开发模式,运行该项目
npm run build:执行生产模式,打包该项目
npm test:执行测试模式,测试该项目
npm run eject:将webpack相关文件暴露出来(React设置webpack文件隐藏,为了防止我们修改其文件导致项目不能运行,执行该命令,将隐藏文件显示且不能再将其隐藏了!!!)
创建完成,将该文件拖到编译器上,我这里是VScode,然后新建终端执行npm start启动项目即可
默认是创建React+JS的项目,如果想创建React+TypeScript的项目,执行如下命令即可。
create-react-app 项目名称 --template typescript
cd 项目名
npm start
npx安装创建(官方推荐)
npx:是一种在npm中安装工具,在 npm version >= 5.2.0 开始,自动安装了npx。目的是提升包内提供的命令行工具的使用体验。
npx create-react-app 是固定命令,create-react-app是React脚手架的名称。
npx 命令会帮助我们临时安装create-react-app包,然后初始化项目完成之后会自自动删掉,所以不需要全局安装create-react-app
新建终端执行如下命令进行安装:
npx create-react-app 项目名称
安装完成后操作过程和上文的全局安装一样,将创建好的react项目文件拖到编译器中新建终端执行 npm start 即可。
总结:
1)安装react脚手架我个人还是推荐使用官方的npx进行安装,即按即用。
2)React的创建者Facebook也创建了一个类似于npm的包管理器 yarn ,yarn具有快速、可靠和安全的特点,我这里完全是用npm了,喜欢yarn的也可以去使用,直接cmd打开终端运行 npm install yarn -g 进行全局安装,以后使用yarn直接用yarn替换npm运行命令即可。
指定React版本安装
npx create-react-app my-app安装默认都是最新的版本,因为React18与React17的语法有些差别如果想使用React17的版本,需要我们指定版本,执行如下代码进行版本降级:
npm install react@17.x react-dom@17.x --save
注意:npm install 安装库@版本号 --save
17.x 表示的更新范围为>=17.0.0&&< 18.0.0
17.2.x 表示的更新范围为>=17.2.0&&< 17.3.0
降级完成之后,对src下的入口文件index.js进行修改,如下:
import React from 'react'
import ReactDOM from 'react-dom'
import App from './App'
// 18
// const root = ReactDOM.createRoot(document.getElementById('root'));
// root.render(
// <React.StrictMode>
// <App />
// </React.StrictMode>
// );
// 17
ReactDOM.render(
<React.StrictMode>
<App />
</React.StrictMode>,
document.getElementById('root')
)
脚手架文件介绍
public文件夹下有如下文件,用于存放静态资源类似图片、logo之类的东西。
在public中最重要的文件就是index.html,其相关文件说明如下(原本无关紧要的注释已经删掉了):
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<!-- %PUBLIC_URL%代表public文件夹的路径 -->
<link rel="icon" href="%PUBLIC_URL%/favicon.ico" />
<!-- 开启理想端口,用于做移动端页面的适配 -->
<meta name="viewport" content="width=device-width, initial-scale=1" />
<!-- 用于配置浏览器页签+地址栏的颜色(仅支持安卓手机浏览器,兼容性较差,可能有的手机并没有效果) -->
<meta name="theme-color" content="#000000" />
<meta
name="description"
content="Web site created using create-react-app"
/>
<!-- 用于指定网页添加到手机主屏幕后的图标 -->
<link rel="apple-touch-icon" href="%PUBLIC_URL%/logo192.png" />
<!-- 应用加壳时的配置文件 -->
<link rel="manifest" href="%PUBLIC_URL%/manifest.json" />
<title>React App</title>
</head>
<body>
<!-- 若浏览器不支持js,则展示标签中的内容 -->
<noscript>You need to enable JavaScript to run this app.</noscript>
<div id="root"></div>
</body>
</html>
ok,具体文件功能介绍完,我们实现一个简单的小案例:Hello React 吧。