重温 Webpack, Babel 和 React

开始以前

在书写文章以前，我假设你们已经有了 JavaScript，Node 包管理工具，Linux 终端操做 这些基本技能，接下来，我将一步一步指引你们从头搭建一个 React 项目

最终实现的效果

咱们将使用 Webpack 和 Babel 搭建一个 React 应用，咱们的目的很清晰，就是 更好的理解和掌握这些工具的使用

咱们建立的应用程序既要作到 最小，也要遵循 最佳实践，为不是特别熟练的同窗巩固一下基础

初始化

建立你的项目，并添加的你的配置文件 package.json

mkdir webpack-babel-react-revisited
cd webpack-babel-react-revisited

yarn init

Webpack

咱们首先安装 Webpack，它是目前很是流行的 模块打包器，它将应用程序包含的每一个模块打包成少许的 块，以便这些代码从服务器加载到浏览器中

yarn add webpack --dev

接下来，咱们开始书写一些模块。咱们将源文件 app.js 保存到 src 目录中

/** app.js */

console.log('Hello from 枫上雾棋!');

而后，咱们跑一下 Webpack

./node_modules/webpack/bin/webpack.js ./src/app.js --output-filename ./dist/app.bundle.js

若是你打开生成的 app.bundle.js，你会发现上面是 webpack 的模块处理代码，下面是咱们书写的 console.log

这条指令是将咱们的 app.js 做为 Webpack 的 入口文件，将结果输出到 dist 文件夹中，指令有些冗长，在实际开发中，咱们使用 webpack 配置文件来代替，为了文档结构看起来更加清晰，参考 目录 以下

├── config
│   ├── paths.js
│   ├── webpack.config.prod.js
├── src
│   ├── app.js
├── package.json

下面是参考 配置

paths.js

const path = require('path');
const fs = require('fs');

const appDirectory = fs.realpathSync(process.cwd());
const resolveApp = relativePath => path.resolve(appDirectory, relativePath);

module.exports = {
  appDist: resolveApp('dist'),
  appSrc: resolveApp('src'),
};

这个文件不是必须的，但在项目增大后，它的意义就瞬间出来了

webpack.config.prod.js

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');

const paths = require('./paths');

const plugins = [
  new HtmlWebpackPlugin({
    title: 'webpack babel react revisited',
    filename: path.join(paths.appDist, 'index.html'),
  }),
];

const config = {
  entry: {
    app: path.join(paths.appSrc, 'app'),
  },
  output: {
    path: paths.appDist,
    filename: 'assets/js/[name].js',
  },
  resolve: {
    extensions: ['.js', '.jsx'],
  },
  plugins,
};

module.exports = config;

这里咱们还添加了一个 html-webpack-plugin，它简化了咱们 HTML 文件的建立，安装咱们就再也不这里赘述了，若是还不知道的同窗能够点击连接查看

其中，咱们还使用了一个 语法糖，这样在咱们导入 .js，.jsx 时就不须要指定扩展名了

接下来，咱们指定配置文件再跑一下 Webpack

./node_modules/webpack/bin/webpack.js --config config/webpack.config.prod.js

发现除了实现上面的效果外，还自动帮咱们生成了一个 index.html，咱们能够点击这个 html，在控制台中查看效果，相比上面，是否是方便了不少

固然，最后咱们确定也不是使用这种方式来 build，打开 package.json，添加以下 脚本命令，而后执行 yarn build，是否是瞬间感受 nice 了不少

"scripts": {
  "clean": "rimraf dist *.log .DS_Store",
  "build": "yarn run clean && webpack --config config/webpack.config.prod.js --progress"
}

Webpack dev server

除此以外，Webpack 为咱们提供了一个的 dev server，它还支持 模块热替换

首先，安装 webpack-dev-server

yarn add --dev webpack-dev-server

在 config 目录中添加配置文件 webpack.config.dev.js

const path = require('path');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const OpenBrowserPlugin = require('open-browser-webpack-plugin');

const paths = require('./paths');

const hostname = process.env.HOST || 'localhost';
const port = process.env.PORT || 3000;

const plugins = [
  new HtmlWebpackPlugin({
    title: 'webpack babel react revisited',
    filename: path.join(paths.appDist, 'index.html'),
  }),
  new OpenBrowserPlugin({ url: `http://${hostname}:${port}` }),
];

const config = {
  entry: {
    app: path.join(paths.appSrc, 'app'),
  },
  output: {
    path: paths.appDist,
    filename: 'assets/js/[name].js',
  },
    resolve: {
    extensions: ['.js', '.jsx'],
  },
  plugins,
  devServer: {
    contentBase: paths.appDist,
    compress: true,
    port,
  },
};

module.exports = config;

在 webpack.config.prod.js 的基础上，咱们增长了 open-browser-webpack-plugin 插件和 devServer 配置，open-browser-webpack-plugin 插件顾名思义，会帮咱们自动打开 dev server 最后返回给咱们的地址

更新 package.json

"scripts": {
  "clean": "rimraf dist *.log .DS_Store",
  "webpack:dev":
    "NODE_ENV=development webpack-dev-server --config config/webpack.config.dev.js --progress",
  "webpack:prod":
    "NODE_ENV=production webpack --config config/webpack.config.prod.js --progress",
  "start": "yarn run clean && yarn run webpack:dev",
  "build": "yarn run clean && yarn run webpack:prod"
}

如今，咱们就能够经过以下方式来启动

yarn start

启动后，有没有瞬间感受很棒

Babel

为了可以使用 ES6 以及更高版本，咱们须要一个 转换编译器，咱们选择 Babel，它能将 ES6 转换成能够在浏览器中运行的代码，除此以外，他还内置了 React JSX 扩展，能够说它的出现推进了 JavaScipt 的发展

全部，咱们安装下面这些依赖包

yarn add --dev babel-loader babel-core babel-preset-env babel-preset-react

建立 Babel 默认配置文件 .babelrc

{
  "presets": ["env", "react"]
}

这个是告诉 Babel 用咱们刚刚安装的两个 presets

接下来，更新 webpack 配置文件

config.module = {
  rules: [
    {
      test: /\.(js|jsx)$/,
      exclude: /node_modules/,
      use: ['babel-loader'],
    },
  ],
}

更新之后，虽然看不到什么变化，但事实上咱们可使用 ES6 了

React

最后，咱们来添加 React，这也多是你阅读这篇文章的缘由

首先，咱们仍是先安装它

yarn add react react-dom

用下面代码替换 console.log

import React, { Component } from 'react';
import { render } from 'react-dom';

export default class Hello extends Component {
  render() {
    return <h1>Hello from 枫上雾棋!</h1>;
  }
}

render(<Hello />, document.getElementById('app'));

由于要添加 <div id="app"></div>，因此咱们要修改一下 html-webpack-plugin 的配置

new HtmlWebpackPlugin({
  template: path.join(paths.appSrc, 'index.html'),
}),

参考 template 以下

<!DOCTYPE html>
<html>
  <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
    <title>webpack babel react revisited</title>
  </head>
  <body>
    <noscript>
      You need to enable JavaScript to run this app.
    </noscript>
    <div id="app"></div>
  </body>
</html>

接下来，就是见证奇迹的时刻

从新启动服务，你有没有发现搭建一个 React 应用程序就这么简单

接下来，你们就能够 自行探索，添加更多的东西来适应自身应用程序的须要

下面再补充一下如何添加 CSS 和 图片

CSS

每一个 web 应用程序都离不开 CSS，咱们在 src 目录中建立 style.css

body,
html,
#app {
  margin: 0;
  width: 100%;
  height: 100%;
}

#app {
  padding: 30px;
  font-family: '微软雅黑';
}

将其添加到应用程序中咱们须要使用 css-loader

若是想将 css 注入 style 标签中，咱们还须要 style-loader，一般，是将这两个结合使用

咱们使用 extract-text-webpack-plugin 将其解压到外部

为此，咱们首先安装

yarn add --dev css-loader style-loader extract-text-webpack-plugin

而后在 app.js 中导入 style.css

import './style.css';

最后更新 webpack 配置文件

config.module = {
  rules: [
    {
      test: /\.css$/,
      use: ExtractTextPlugin.extract({
        fallback: 'style-loader',
        use: 'css-loader',
      }),
    },
  ],
}

config.plugins.push([
  new ExtractTextPlugin("styles.css"),
])

看起来稍显复杂，可是大功告成，为了更好地使用它，咱们都得经历这个过程

从新启动服务，你会发现你的 dist 目录中多了一个 styles.css

图片

最后咱们增长 file-loader 来处理咱们引入的图片等文件

首先，安装 file-loader

yarn add --dev file-loader

咱们在 src/images 中放入一张图片，在 app.js 中导入

import avatar from './images/avatar.jpg';

export default class Hello extends Component {
  render() {
    return (
      <div>
        <img src={avatar} alt="avatar" style={{ width: 400, height: 250 }} />
      </div>
    );
  }
}

更新 webpack 配置文件

config.module = {
  rules: [
    {
      test: /\.(png|jpg|gif)$/,
      use: [
        {
          loader: 'file-loader',
          options: {
            name: '[name].[ext]',
            outputPath: 'assets/images/',
          },
        },
      ],
    },
  ],
}

重启服务，哈哈

总结

若是有什么问题，能够查看 webpack-babel-react-revisited 仓库

如今，你们对搭建 React 应用程序是否是感受轻松了不少，但 React 整个技术栈并不止包括这些，还有 Redux，React Router，单元测试，代码校验 等内容，关于 React 其余内容，欢迎查看日志其余文章

原文连接：Setting up Webpack, Babel and React from scratch, revisited