webpack构建工具快速上手指南
最近在研究react项目,接触到webpack打包工具。刚接触的时候一脸茫然,经过最近的学习,下面我来带大家开启webpack入门之旅。
webpack是什么
webpack是近期最火的一款模块加载器兼打包工具,它能把各种资源,例如JS(含JSX)、样式(含less/sass)、图片等都作为模块来使用和处理。当 webpack 处理应用程序时,它会递归地构建一个依赖关系图(dependency graph),其中包含应用程序需要的每个模块,然后将所有这些模块打包成少量的 bundle - 通常只有一个,由浏览器加载。 当然做react项目也可以不用webpack构建工具,可以用gulp或者grunt等构建工具,但是GitHub 上面rect相关项目都是用webpack来构建的,官方推荐也是webpack更为合适,所以我们没有理由不掌握它。
Webpack的工作方式是:把你的项目当做一个整体,通过一个给定的入口文件(如:index.js),Webpack将从这个文件开始找到你的项目的所有依赖文件,使用loaders处理它们,最后打包为一个浏览器可识别的JavaScript文件。
webpack 的优势
-
在webpack看来一切都是模块,包括javascript、css以及图片等。
-
开发便捷,能替代部分 grunt/gulp 的工作,比如打包、压缩混淆、图片转base64等。。
-
扩展性强,插件机制完善。
webpack文件配置
webpack有四个核心概念:入口(entry)、输出(output)、加载器(loader)、插件(plugins)。下面来看一下webpack.config.js文件
const webpack = require('webpack');
const ExtractTextPlugin = require('extract-text-webpack-plugin'); //css单独打包插件 module.exports = { //页面入口文件 entry: { app: './src/app' }, //打包文件输出配置 output: { path: 'dist/js',//打包输出路径 filename: '[name].min.js',//文件名字 }, //自动扩展文件后缀名,意味着我们在项目中import模块可以省略不写后缀名 resolve: { extensions: ['.js', '.jsx'] }, //模块加载器(图片/js/css/等等) module: { rules: [{ test: /\.(js|jsx)$/, exclude: /^node_modules$/, use: [{ loader: 'babel-loader', options: { presets: ['es2015', 'react'], plugins: ["transform-object-rest-spread"] } }] },{ test: /\.less$/, exclude: /^node_modules$/, loader: ExtractTextPlugin.extract({ fallback: 'style-loader', use: 'css-loader!less-loader' }) }, { test: /\.(png|jpg|gif)$/, exclude: /^node_modules$/, include: path.resolve(__dirname, './img'), loader: 'url-loader', options: { limit: 8192 //图片文件小于8kb的直接转为base64 } }] }, //插件项(这里用里一个css单独打包,否则css文件会和js文件打包在一起) plugins: [ new ExtractTextPlugin("styles.min.css") ] }
生产环境webpack.prod.js配置
webpack 自带了 UglifyJsPlugin
,它运行 UglifyJS来压缩输出文件。
// webpack.prod.js const webpack = require('webpack'); const HtmlWebpackPlugin = require('html-webpack-plugin') module.exports = { /*...*/ new webpack.optimize.UglifyJsPlugin({ output: { comments: false // 删除注释 }, compress: { warnings: false // 不显示警告,默认为false } }), new HtmlWebpackPlugin({ //根据模板插入css/js等生成最终HTML filename: 'build/', //生成的html存放路径 template: './src/template/index.html', //html模板路径 hash: true, //为静态资源css文件和js生成hash值 title: '口袋', favicon: './img/favicon.ico', inject: true, //所有js资源放到body底部 minify: { removeComments: true, //去掉注释 collapseWhitespace: true, //去掉空格 minifyCSS: true, //压缩html里的css minifyJS: true //压缩html里的js } }), };
html-webpack-plugin插件详解请看(https://www.npmjs.com/package/html-webpack-plugin)
安装方法
$ npm install webpack -g
运行webpack
webpack --display-error-details 后面参数“--display-error-details”是推荐加上的,方便出错时能更好定位到问题。 其他主要参数有:
$ webpack --watch //监听变动并自动打包
$ webpack -p //压缩混淆脚本
$ webpack -d //生成map映射文件,告知哪些模块被最终打包到哪里了
下面我们添加一个用于启动 webpack 的 npm script 脚本:
package.json
{ "name": "demo", "version": "1.0.0", "description": "", "main": "webpack.config.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "dev": "webpack-dev-server --config webpack.config.js --inline --hot", "build": "webpack --config webpack.prod.config.js" }, "keywords": [], "author": "", "license": "ISC", "devDependencies": { "css-loader": "^0.28.4", "csv-loader": "^2.1.1", "file-loader": "^0.11.2", "html-webpack-plugin": "^2.29.0", "style-loader": "^0.18.2", "webpack": "^3.0.0", } }
开发环境运行方法
使用 webpack-dev-server
开发服务是一个更好的选择。webpack-dev-server是一个小型的Node.js Express服务器,它将启动一个 express 静态资源 web 服务器,并且会以监听模式自动运行 webpack,在浏览器打开 http://localhost:8080/ (端口号可配置) 可以浏览项目中的页面和编译后的资源输出,并且通过一个 socket.io 服务实时监听它们的变化并自动刷新页面。
现在,我们可以在命令行中运行 npm start,就会看到浏览器自动加载页面。如果现在修改和保存任意源文件,web 服务器就会自动重新加载编译后的代码。赶紧试一下!有一点需要注意的是:webpack-dev-server启动项目生成的包并没有放在你的真实目录中,而是放在了内存中,你从chrome浏览器中Source面板中可以看见.
生产环境运行方法
使用 npm run build启动项目
基于 webpack 指引就写到这里,要是看了之后能够让一脸的茫然的你豁然开朗,可以请我喝咖啡,你也可以参考下述的文章来入门:
[http://zhaoda.net/webpack-handbook/install.html]
[http://webpack.github.io/docs/]