从零到一搭建 react 项目系列之(五)

上一篇介绍完 HMR 热更新之后,接着我们会讲解 React 项目搭建。

题外话

首先官方提供了一个 create-react-app 脚手架工具来创建 React 项目。

*本项目不采用该脚手架进行搭建。
*下面使用 npm 举例,与 yarn 大同小异。
*仅简述,不感兴趣可跳过该内容。

# 安装 create-react-app
$ npm install -g create-react-app

# 创建项目
$ create-react-app your_project

# 打开项目
$ cd your_project

# 运行项目
$ npm run start

# 项目打包
$ npm run build

# 自定义配置,注意执行这个命令是不可逆的
$ npm run eject

我们通过 create-react-app 创建的项目,可以看到它只有 reactreact-domreact-scripts 等少数依赖。其实,它将 webpackBabelESLint 等依赖包通过 creat-react-app 封装到了 react-scripts 当中,包括基本启动命令都是通过调用 react-scripts 这个依赖下面的命令来完成的。

除了 startbuildtest 命令。它还有一个 "eject": "react-scripts eject" 命令。它的作用是什么呢?

它会将原本 creat-react-appwebpackBabelESLint 等相关配置的封装“弹出”。假如我们要将creat-react-app 配置文件进行修改,现有目录下是没有地方修改的。此时,我们就可以通过 npm run eject 命令将原本被封装到脚手架当中的命令弹射出来,然后在项目目录下看到很多配置文件。注意,该命令是单向操作,不可逆。(在 README.md 中对此命令有简述。)

使用 Babel

Babel 是什么?

Babel 是一个工具链,主要用于将 ECMAScript 2015+ 版本的代码转换为向后兼容的 JavaScript 语法,以便能够运行在当前和旧版本的浏览器或其他环境中。下面列出的是 Babel 能为你做的事情:

  • 语法转换
  • 通过 Polyfill 方式在目标环境中添加缺失的特性 (通过 @babel/polyfill 模块,babel 7.4 开始废弃 @babel/polyfill)
  • 源码转换 (codemods)
  • 更多! (查看这些 视频 获得启发)
babel 配置
  1. 安装依赖
$ yarn add --dev babel-loader@8.0.6 @babel-core/core@7.7.4
  1. 添加 module.rules 配置
// webpack.config.js
{
  test: /\.js$/,
  exclude: /node_modules/,
  use: 'babel-loader'
}
  1. 创建 .babelrc 配置文件
    我们已经配置了 Babel,但实际上并未做任何事情。在项目根目录中创建一个 .babelrc 配置文件(JSON),并启用一些预设和插件。
  • @babel/preset-env:解析 ES6 语法,它只做语法转换,如 constlet。它并不处理 includesPromise 等 api。
  • @babel/preset-react:解析 JSX 语法。
  • @babel/plugin-transform-runtime:解决全局变量污染,以及重复声明 helper 函数的问题。
$ yarn add --dev @babel/preset-env@7.7.4
$ yarn add --dev @babel/preset-react@7.7.4
$ yarn add --dev @babel/plugin-transform-runtime@7.7.4
$ yarn add --dev core-js@3.6.0
// .babelrc
{
  "presets": [
    [
      "@babel/preset-env",
      {
        "modules": false, // 将 ESM 转化为其他模块规范,默认值 false。
        "useBuiltIns": "usage", // 按需加载
        "corejs": 3, // Babel 建议使用 useBuiltIns 选项时显式设置 core-js 版本
        "debug": false // 打印插件使用情况
      }
    ],
    "@babel/preset-react" // 解析 JSX 语法
  ],
  "plugins": ["@babel/plugin-transform-runtime"]
}

*关于 .babelrc 相关预设与插件详解,在后续会专门出一篇文章整理介绍;
*顺序问题:1 Plugins 在 Presets 前运行;2 Plugins 按照声明次序顺序执行;3 Presets 按照声明次序逆序执行。

React

  1. 首先安装 reactreact-dom 依赖包。
$ yarn add react@16.12.0 react-dom@16.12.0

插个话题:为什么 react 和 react-dom 要分成两个包?

对于具有跨平台能力的 React 体系来说,分包可以将抽象逻辑与平台实现分开。

  • react 包即是抽象逻辑,它包含了 React 的主干逻辑。例如组件实现、更新调度等。
  • react-dom 顾名思义就是一种针对 dom 的平台实现,主要用于在 web 端进行渲染。而声名在外的 React Native 则是原生应用实现,可以通过 React Native 内部的相应机制与操作系统进行通信来调用原生控件进行渲染。

*以上简述来自知乎 Shockw4ver 回答。

  1. 引入 react
// index.js
import React from 'react'
import { render } from 'react-dom'
import './main.js'
import './style.css'

// 最简单的 React 示例
const rootElem = document.getElementById('app')
render(<div>Hello React!</div>, rootElem)

if(module.hot) {
  module.hot.accept('./main.js', () => {
    console.log('Accept update!')
  })
}
<!-- index.html -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title><%= htmlWebpackPlugin.options.title %></title>
  </head>
  <body>
    <div id="app"></div>
  </body>
</html>

至此,最简单的 React 示例已经成功了。


接下来,我们将会先介绍接入 react-hot-loader 实现 react 的局部刷新问题。

最后附上

// package.json
{
  "name": "webpack4_demo",
  "version": "1.0.0",
  "description": "从零到一搭建 react 项目",
  "main": "src/index.js",
  "repository": "git@github.com:toFrankie/webpack4_demo.git",
  "author": "Frankie <1426203851@qq.com>",
  "license": "MIT",
  "private": true,
  "scripts": {
    "dev": "webpack-dev-server --config webpack.config.js --colors",
    "build": "webpack --config webpack.config.js --progress --colors --mode=production"
  },
  "dependencies": {
    "react": "16.12.0",
    "react-dom": "16.12.0",
    "webpack": "4.41.2",
    "webpack-cli": "3.3.10"
  },
  "devDependencies": {
    "@babel/core": "7.7.4",
    "@babel/plugin-transform-runtime": "7.7.4",
    "@babel/preset-env": "7.7.4",
    "@babel/preset-react": "7.7.4",
    "babel-loader": "8.0.6",
    "clean-webpack-plugin": "3.0.0",
    "core-js": "3.6.0",
    "css-loader": "3.2.0",
    "html-webpack-plugin": "3.2.0",
    "style-loader": "1.0.0",
    "webpack-dev-server": "3.9.0"
  }
}
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,163评论 6 498
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,301评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,089评论 0 352
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,093评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,110评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,079评论 1 295
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,005评论 3 417
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,840评论 0 273
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,278评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,497评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,667评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,394评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,980评论 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,628评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,796评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,649评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,548评论 2 352