開始之前

在書寫文章之前，我假設(shè)大家已經(jīng)有了 JavaScript，Node 包管理工具，Linux 終端操作 這些基本技能，接下來，我將一步一步指引大家從頭搭建一個 React 項目

最終實現(xiàn)的效果

我們將使用 Webpack 和 Babel 搭建一個 React 應(yīng)用，我們的目的很清晰，就是 更好的理解和掌握這些工具的使用

我們創(chuàng)建的應(yīng)用程序既要做到 最小，也要遵循 最佳實踐，為不是特別熟練的同學鞏固一下基礎(chǔ)

初始化

創(chuàng)建你的項目，并添加的你的配置文件 package.json

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

yarn init

Webpack

我們首先安裝 Webpack，它是目前非常流行的 模塊打包器，它將應(yīng)用程序包含的每個模塊打包成少量的 塊，以便這些代碼從服務(wù)器加載到瀏覽器中

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，你會發(fā)現(xiàn)上面是 webpack 的模塊處理代碼，下面是我們書寫的 console.log

這條指令是將我們的 app.js 作為 Webpack 的 入口文件，將結(jié)果輸出到 dist 文件夾中，指令有些冗長，在實際開發(fā)中，我們使用 webpack 配置文件來代替，為了文檔結(jié)構(gòu)看起來更加清晰，參考 目錄 如下

├── 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 文件的創(chuàng)建，安裝我們就不再這里贅述了，如果還不知道的同學可以點擊鏈接查看

其中，我們還使用了一個 語法糖，這樣在我們導入 .js，.jsx 時就不需要指定擴展名了

接下來，我們指定配置文件再跑一下 Webpack

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

發(fā)現(xiàn)除了實現(xiàn)上面的效果外，還自動幫我們生成了一個 index.html，我們可以點擊這個 html，在控制臺中查看效果，相比上面，是不是方便了很多

當然，最后我們肯定也不是使用這種方式來 build，打開 package.json，添加如下 腳本命令，然后執(zhí)行 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 的基礎(chǔ)上，我們增加了 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"
}

現(xiàn)在，我們就可以通過如下方式來啟動

yarn start

啟動后，有沒有瞬間感覺很棒

Babel

為了能夠使用 ES6 以及更高版本，我們需要一個 轉(zhuǎn)換編譯器，我們選擇 Babel，它能將 ES6 轉(zhuǎn)換成可以在瀏覽器中運行的代碼，除此之外，他還內(nèi)置了 React JSX 擴展，可以說它的出現(xiàn)推動了 JavaScipt 的發(fā)展

所有，我們安裝下面這些依賴包

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

創(chuàng)建 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>

接下來，就是見證奇跡的時刻

重新啟動服務(wù)，你有沒有發(fā)現(xiàn)搭建一個 React 應(yīng)用程序就這么簡單

接下里，大家就可以 自行探索，添加更多的東西來適應(yīng)自身應(yīng)用程序的需要

下面再補充一下如何添加 CSS 和 圖片

CSS

每個 web 應(yīng)用程序都離不開 CSS，我們在 src 目錄中創(chuàng)建 style.css

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

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

將其添加到應(yīng)用程序中我們需要使用 css-loader

如果想將 css 注入 style 標簽中，我們還需要 style-loader，通常，是將這兩個結(jié)合使用

我們使用 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"),
])

看起來稍顯復雜，但是大功告成，為了更好地使用它，我們都得經(jīng)歷這個過程

重新啟動服務(wù)，你會發(fā)現(xiàn)你的 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/',
          },
        },
      ],
    },
  ],
}

重啟服務(wù)，哈哈

總結(jié)

如果有什么問題，可以查看 webpack-babel-react-revisited 倉庫

現(xiàn)在，大家對搭建 React 應(yīng)用程序是不是感覺輕松了很多，但 React 整個技術(shù)棧并不止包括這些，還有 Redux，React Router，單元測試，代碼校驗 等內(nèi)容，關(guān)于 React 其他內(nèi)容，歡迎查看日志其他文章

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