webpack 2.x配置reactjs基本开发环境

当前webpack版本：2.2；react: 15.4.2

webpack从1.x升级到2.x替换了几个接口，包括module.loaders这样的重要接口已被弃用（详细变更）。官网目前已不推荐使用1.x版本，早上折腾一番，根据2.2版本配置了react基本的开发环境，满足不太复杂的web应用开发，后期会逐步优化配置文件。

如果您之前使用过webpack，需要改动的地方并不大。下文假定您没有接触过类似的打包工具（但了解npm、jsx再好不过），以跟我一样一个新手的身份认识这些，如有不妥之处望不吝赐教。

如果您的react项目是引入的以下三个js文件在浏览器端编译jsx，那么不需要用webpack做开发环境。

<script src="https://cdn.bootcss.com/react/15.4.2/react.min.js"></script>
<script src="https://cdn.bootcss.com/react/15.4.2/react-dom.min.js"></script>
<script src="https://cdn.bootcss.com/babel-standalone/6.22.1/babel.min.js"></script>

但是在产品上线阶段，我们很不推荐这样做。1，用户需要下载这三个文件，浪费了带宽；2，下载完成后需要在浏览器端编译jsx文件，浪费了时间和资源。

如果将开发阶段的项目代码打包编译为一个js文件，再推上线，那么：1，将HTTP请求减少为1个；2，不需要用户端再浪费时间和资源去编译，直接运行上线前已编译好的js代码。

如果是前者，引入项目js代码的script标签type值为"text/babel"；如果是后者，type值为"text/javascript"。

如何做？

一，安装nodejs，使用它附带的npm包管理工具。为什么要用npm？后期会下载react依赖、babel依赖、webpack工具，使用npm方便很多。不使用npm也可以，但无疑会增加诸多困难。

二，新建一个项目文件夹，在文件夹内打开终端，即Windows下的命令行（Shift+鼠标右键），运行 npm init ，如果没有特殊要求，可一直按回车键到最后一步。

三，在终端内执行如下命令下载需要的所有依赖和工具， --save-dev 详见SegmentFault解释

npm install react react-dom babel-loader babel-core babel-preset-es2015 webpack webpack-dev-server --save-dev

四，配置webpack配置文件。在根目录下，即与package.json同级下新建webpack.config.js文件，在文件内部写入如下内容

// webpack.config.js
var webpack = require("webpack");
var path = require("path");

module.exports = {
    entry: './dev/entry.jsx', // 入口文件
    devtool: 'source-map',　　// 调试时定位到编译前的代码位置，推荐安装react插件
    output: {
        path: path.resolve(__dirname, "./dist/js/"),
        filename: 'bundle.js' // 打包输出的文件
    },
    module: {
        rules: [{
            test: /.jsx?$/, // test 去判断是否为.js或.jsx,是的话就是进行es6和jsx的编译
            exclude: /(node_modules|bower_components)/,
            loader: 'babel-loader',
            query: {
                presets: ['es2015', 'react']
            }
        }]
    },
    resolve: {
        // 现在你import文件的时候可以直接使用import Func from './file'，不用再使用import Func from './file.js'
        extensions: ['.js', '.jsx', '.json', '.coffee']
    }
};

 目录结构：

    app
    |__dev
    |   |__components
    |   |__entry.jsx
    |__dist
    |   |__css
    |   |__js
    |       |__bundle.js
    |   |__index.html
    |__node_modules
    |__package.json
    |__webpack.config.js

对于这份配置文件有如下说明

1，标红的部分可自定义

2，react项目文件可以用js格式，也可以用jsx格式，但是输出文件为在HTML文件中引用的文件，必须为js格式。

3，本配置入口文件在dev目录下，输出文件在dist目录下，具体可自定义配置。

4，module.rules为2.x新增的接口，代替原先使用的module.loaders

5，去掉query会报错，也可将其规则写入package.json文件，具体写法见参考链接

五，在package.json文件scripts部分添加如下代码

  "scripts": {
    "test": "echo "Error: no test specified" && exit 1",
    "start": "webpack-dev-server --hot --open --content-base ./dist/",
    "deploy": "webpack -p --progress --config webpack.config.js"
  },

　　注：--content-base参数指定根html文件所在位置。

六，开发阶段在终端使用 npm start 自动编译代码并刷新；使用 npm run build 编译生产环境代码。

　　注：webpack-dev-server自动编译代码和刷新浏览器并不会将编译后的文件写入磁盘，而是保持在内存中，因此此时在html文件中引入的脚本文件src为"bundle.js"，没有任何路径，如果在webpack.config.js的ouput中指定了"publicPath"，情况又有所不同，详见参考链接第三个。

附：webpack编译过程中常用的参数，可在scripts编译命令中分别配置

• webpack 开发环境下编译
• webpack -p 产品编译及压缩
• webpack --watch 开发环境下持续的监听文件变动来进行编译(非常快!)
• webpack -d 引入 source maps

eslint支持：

npm i eslint babel-eslint eslint-plugin-react --save-dev

新建一个.eslintrc文件，写入react支持基本参数

{
    "plugins": ["react"],
    "extends": ["eslint:recommended", "plugin:react/recommended"],
    "parser": "babel-eslint"
}

推荐安装编辑器对应的eslint插件，可以在界面实时显示错误信息。

参考链接：webpack-howto 、w3cplus、segmentfault