React+Redux+Webpack构建开发单页应用环境

@H_403_1@

webpack 基础

@H_403_1@

安装 webpack

$ npm install -g webpack
 $ webpack -v

作为项目依赖安装

$ npm install webpack --save-dev

@H_403_1@

webpack 简介

webpack 的配置项主要包括以下几点：

entry: 入口,定义要打包的文件
output: 出口，定义打包输出的文件；包括路径，文件名，还可能有运行时的访问路径（publicPath）参数
module: webpack将所有的资源都看做是模块，而模块就需要加载器；主要定义一些loaders,定义哪些后缀名的文件应该用哪些loader
test: 检测哪些文件需要此loader，是一个正则表达式
exclude: 忽略哪些文件
resolve: 定义能够被打包的文件，文件后缀名
plugins: 定义一些额外的插件

Loaders

处理样式：less-loader、style-loader、css-loader，将 less 转成 css
图片处理，url-loader、file-loader、image-webpack-loader，将图片转换成base64 或者进行压缩
js处理： babel-loader，babel-preset-es2015，babel-preset-react，stage-0,将es6或更高级的代码转成es5的代码

Plugins

代码热替换：HotModuleReplacementPlugin
生成html文件：HtmlWebpackPlugin
报错但不退出webpack进程：NoErrorsPlugin
代码压缩：UglifyJsPlugin
自动打开浏览器： OpenBrowserPlugin
设置环境变量： DefinePlugin

@H_403_1@

使用 webpack-dev-server 启动服务器

webpack.config.***.js: webpack常规配置，配置入口文件，输出文件，loaders等等
server.js: 将server部分分离到一个单独到的文件配置
package.json: 自定义启动命令

<!-- webpack.config.dev.js -->

const webpack = require('webpack');
const path = require('path');
const OpenBrowserPlugin = require('open-browser-webpack-plugin');
const HtmlWebpackPlugin = require('html-webpack-plugin');
const DashboardPlugin = require('webpack-dashboard/plugin');
const configBase = require('./config.base')
const ip = require('ip')
const lostIp = ip.address()
const config = {
  entry: [
    'webpack/hot/dev-server','webpack-dev-server/client?http://' + lostIp + ':' + configBase.port,path.resolve(__dirname,configBase.project + '/index.js')
  ],output: {
    filename: 'bundle.js',path: path.resolve(__dirname,'build'),publicPath: 'http://' + lostIp + ':' + configBase.port + '/' // 引用路径
  },resolve: {
    extensions: [ '','.js','.jsx' ]
  },devtool: "source-map",module: {
    loaders: [
      {
        test: /\.js|jsx$/,// 正则匹配
        exclude: /(node_modules|bower_components)/,loaders: [ 'babel','eslint-loader']  // 加载模块 "babel" 是 "babel-loader" 的缩写  eslint 语法检查
      },{
        test: /\.css$/,loaders: [ "style","css?sourceMap" ]
      },{
        test: /\.(woff|woff2|eot|ttf)$/i,loader: "file-loader?name=fonts/[name]-[hash].[ext]"
      },{
        test: /\.less$/,loader: "style!css!less"
      },{
        test: /\.(jpe?g|png|gif|svg|ico)$/i,loaders: [
          'url?limit=10000&name=img/[hash:8].[name].[ext]',// 图片小于8k就转化为 base64,或者单独作为文件
          'image-webpack' // 图片压缩
        ]
      }
    ]
  },eslint: {
    configFile: './.eslintrc'  // eslint配置文件
  },plugins: [
    new HtmlWebpackPlugin({
      favicon: configBase.project + '/favicon.ico',template: configBase.project + '/template.html',filename: 'index.html',inject: true,//允许插件修改哪些内容，包括head与body
      hash: true,//为静态资源生成hash值
      minify: {    //压缩HTML文件
        removeComments: true,//移除HTML中的注释
        collapseWhitespace: true    //删除空白符与换行符
      }
    }),new webpack.DefinePlugin({
      'process.env.NODE_ENV': JSON.stringify('development'),__DEV__: JSON.stringify(JSON.parse(process.env.DEBUG || 'false'))
    }),new webpack.HotModuleReplacementPlugin(),new webpack.NoErrorsPlugin(),new OpenBrowserPlugin({ url: 'http://' + lostIp + ':' + configBase.port }),new DashboardPlugin()
  ]
}

module.exports = config

<!-- server.js -->

const webpack = require('webpack');
const express = require('express')
const webpackDevServer = require('webpack-dev-server');
const webpackDevMiddleware = require('webpack-dev-middleware');
const webpackHotMiddleware = require('webpack-hot-middleware');
const proxy = require('proxy-middleware')
const devConfig = require('./webpack.config.dev.js');
const configBase = require('./config.base')

const port = configBase.port;

const ip = require('ip')
const lostIp = ip.address()
// const app = express()
// const compiler = webpack(devConfig);

// app.use(webpackDevMiddleware(compiler,{
//     publicPath: devConfig.output.publicPath,//     stats: { colors: true },// 用颜色标识
//   }
// ))
// app.use(webpackHotMiddleware(compiler));
// app.use(proxy(configBase.proxyIp));
// app.listen(port,lostIp,function (err) {
//   if (err) {
//     console.log(err);
//   }
//   console.log('------>服务启动中 ' + lostIp + ' port ' + port + '<------');
// });
//
// app.get('/',function (req,res) {
//   console.log(req.url);
//   // res.sendFile(path.join(__dirname,'./dist/index.html'));
// });
//
// app.get('/api','./dist/index.html'));
// });

function baseConfig (config,contentBase) {
  return new webpackDevServer(webpack(config),{
      historyApiFallback: true,//启用历史API后备支持
      hot: true,//添加HotModuleReplacementPlugin和切换服务器热模式
      inline: true,//嵌入的WebPack-dev的服务器运行到包
      progress: true,//显示某种进度条
      contentBase: contentBase,//为内容的基本路径
      stats: { colors: true },// 用颜色标识
    }
  );
}

var server
server = baseConfig(devConfig,"/" + configBase.project);
console.log("开发环境 development mode... " + '项目 ' + configBase.project);

server.listen(port,function (err) {
  if (err) {
    console.log(err);
  }
  console.log('------>服务启动中 ' + lostIp + ' on ' + process.env.NODE_ENV + ' port ' + port + '<------');
});

@H_403_1@

配置 React,ES6 & Babel 6

ES6 和 JSX 转换 .babelrc 文件

{
  "presets": [
    "es2015","stage-0","react"
  ],"plugins": []
}

@H_403_1@

使用 ESlint 进行代码检查

特点:

默认规则包含所有 JSLint、JSHint 中存在的规则，易迁移
规则可配置性高：可设置「警告」、「错误」两个 error 等级，或者直接禁用

.eslint配置文件常见的格式

{
  "parserOptions": { //EsLint通过parserOptions，允许指定校验的ecma的版本，及ecma的一些特性
    "ecmaVersion": 6,//指定ECMAScript支持的版本，6为ES6
    "sourceType": "module",//指定来源的类型，有两种”script”或”module”
    "ecmaFeatures": { // ecmaFeatures指定你想使用哪些额外的语言特性
        "jsx": true //启动JSX
    }
  },"parser": "babel-eslint",// EsLint默认使用esprima做脚本解析，也可以切换成babel-eslint解析
  "env": { // Environment可以预设好的其他环境的全局变量，如brower、node环境变量、es6环境变量、mocha环境变量等
    "browser": true,"node": true,"es6": true,"mocha": true
  },"plugins": [ // EsLint允许使用第三方插件
    "react"
  ],extends: [ // Extends是EsLint默认推荐的验证你可以使用配置选择哪些校验是你所需要的
    "eslint:recommended"
  ],rules: [ // 自定义规则
  ],"globals": { // 即插件在执行过程中用到的其它全局变量
  }
}