react+webpack开发环境配置

　　react是目前非常热门的前端框架，提倡组件化开发。所谓的组件，简单理解，就是一个独立的页面部件（包括页面模版，样式，逻辑等），它是一个独立的整体。

　　webpack，是一个模块打包工具，其主要功能，就是将浏览器端无法识别的代码，通过各种loader和plugin，生成浏览器可用的代码。比如，我们可以在浏览器端使用ES2015和JSX编码的文件。

　　在使用react进行组件化开发之前，我们首先需要配置一个我们可以使用的开发环境，下面，我们将一步步讲解，配置一个基本的开发环境。其中安装的文件都是当前最新版本。在开始之前，请先保证你已经安装了node。

1. 创建测试项目

　　为了可以让我们每一步都可以进行测试，了解其中都做了什么，我们提前编写我们的测试项目。大家可以先不用深入理解。（在我们以后的项目中，我们可能会用JSX文件和sass文件，在这里我们尽量真实且简单的还原项目）。

　　1）首先我们创建一个项目文件夹，名为test

　　2）在文件中添加index.jsx，hello.jsx, index.scss, index.html

 // index.scss
 
 $color: #f40;
 
 h1 {
     color: $color;
 }

 // hello.jsx
 module.exports = 'Hello React';

 // index.jsx
 // 引入react和react-dom模块
 // 使用ES2015模块导入语法
 import React from 'react';
 import ReactDOM from 'react-dom';
 
 // 引入自定义的hello.jsx
 var text = require('./hello.jsx');
 
 // 引入我们编写的sass文件
 require('./index.scss');
 
 // 编写一个简单的组件
 class App extends React.Component {
     render(){
         return (
             <h1>{text}</h1>
         );
     }
 };
 
 // 创建一个组件实例，将组件挂载到文档结构中
 ReactDOM.render(<App />, document.body);

 // index.html
 
 <!DOCTYPE html>
 <html>
   <head>
     <meta charset="UTF-8">
     <title>My test</title>
   </head>
   <body>
       <script type="text/javascript" src="bundle.js"></script> // bundle.js是由webpack自动生成的文件，文件名通过配置webpack设置
   </body>
 </html>

　　以上是我们项目的基本结构。

　　为了方便项目文件的管理，我们使用npm，在项目根目录下使用npm init --yes，在根目录下生成一个package.json，管理项目依赖等。

2. 安装webpack

　　1）以命令行工具的形式使用webpack时，在全局安装webpack。

　　npm install webpack -g

　　2) 编写自己的构建脚本，或由项目指定需要依赖的webpack，本地安装，webpack只是构建工具的角色，应该安装在dev－dependencies中，但是，目前我们只使用命令行工具，这种安装方式，只是作为介绍，在之后的搭建过程中并不会用到。

　　npm install webpack --save-dev

3. 配置基本的webpack

　　在项目根目录下添加webpack.config.js配置文件，它是一个Node.js模块格式的配置文件，直接导出一个配置对象。

 // 用于拼接路径
 var path = require('path');
 
 module.exports = {
     // 指定项目入口
     entry: path.resolve(__dirname, 'index.jsx'),
 
     // 对输出结果描述
     output: {
         // 输出路径
         path: path.resolve(__dirname, 'build'),
         // 输出的文件名
         filename: 'bundle.js'
     },
 
     // 配置模块使用的加载器
     module: {
         loaders: [
         {
             // 假设我们拥有一个编译sass加载器
             // 匹配字符串
             test:/\.scss$/,
             // 使用的加载器，不可以省略加载器的后缀-loader
             loaders:['style-loader', 'css-loader', 'sass-loader']
         }
     }
 }

4. babel，sass加载器

　　可以从我们的项目结构中发现，我们使用了.jsx文件和.scss文件，浏览器中无法正常使用这类文件，我们通过添加加载器，将进行解析，以便浏览器使用。

　　1）babel加载器

　　npm install babel-core babel-loader --save-dev

　　2）配置.babelrc文件

　　　　在项目根目录下创建一个.babelrc文件，存放一个对象，分别用presets字段存放规则，plugins字段存放插件，目前我们只用到ES2015和react规则

　　npm install babel-preset-es2015 babel-preset-react --save-dev // 添加规则

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

　　3) sass加载器

　　npm install node-sass style-loader css-loader sass-loader --save-dev

　　4) 配置webpack.config.js配置文件

     // 模块部分更新为下面代码
 
     module: {
         loaders: [
         {
             test:/\.scss$/,
             loaders:['style-loader', 'css-loader', 'sass-loader']
         },
         {
             test:/\.jsx?$/,
             loaders: ['babel-loader']
         }]
     },

　　此时即可正常加载.scss和.jsx文件。

5. 安装react和react-dom

 npm install react react-dom --save

　　到此，我们在项目根目录下执行webpack已经已经在根目录下生成一个bundle.js文件，我们可以正常在index.html文件文件引用，并且在浏览器中查看。

之后的内容，我们将会介绍webpack的插件的用法，以及webpack-dev-server配置方法。

1. html-webpack-plugin

　　我们可以发现我们index.html文件中，只是一个空的HTML结构和引入了生成的bundle.js文件，因此我们可以利用html-webpack-plugin插件来自动生成index.js文件。

　　1) 下载插件

　　npm install html-webpack-plugin --save-dev

　　2）配置webpack.config.js文件

　　首先在文件头部引入插件，然后在添加一个plugins字段，并在其中一个插件对象实例。

 var HtmlWebpackPlugin = require('html-webpack-plugin');
 
 module.exports ={
    plugins: [
         new HtmlWebpackPlugin({
             title: 'My test'
         })
     ]
 }

　　此时我们删除index.html和bundle.js，webpack自动在build路径下创建这两个文件。

2. webpack-dev-server

　　我们可以使用webpack --wacth来监控代码，只要代码一修改，自动更新bundle.js，但是浏览器的网页还需要手动刷新。在开发工程中，非常的不方便。webpack-dev-server为我们解决了这个问题，它是一个小型服务器，在开发过程中可以实时刷新网页。

　　下面我们来安装配置webpack-dev-server。

　　1）全局安装webpack-dev-server

　　npm install webpack-dev-server -g

　　2）配置webpack-dev-server

     // 添加devServer字段,其中字段变动比较大，配置时需要根据文档进行配置
     devServer: {
         historyApiFallback: true,
         inline: true,
         contentBase:'./build/',
         port:'8086'   // 我电脑上默认的8080端口无法访问，所以设置port为8086
     },

　　3）设置运行快捷方式

　　在package.json中的scripts字段中添加下面一行，在命令行中输入npm run dev，直接启动webpack-dev-server，可以在指定端口进行访问。

   "scripts": {
     "dev": "webpack-dev-server"
   },

3. 组件热加载（HMR）

　　我们在上述描述下，搭建的环境，每修改一次代码，页面都会整体刷新一次，我们更希望，页面局部刷新修改的组件。因此就有了组件热加载这个概念。我们可以直接安装babel-preset-react-hmre实现HMR。

　　npm install babel-preset-react-hmre --save-dev

.babelrc中的配置改为：

 {
   "presets": ["react", "es2015"],
   "env": {
     "development": {
       "presets": ["react-hmre"]
     }
   }
 }

并将启动命令改为：

"scripts": {
    "dev": "webpack-dev-server --hot"
  },

此时我们在命令行输入npm run dev，即可。

完成项目github地址：https://github.com/DiligentYe/react-webpack-env