原文地址：https://segmentfault.com/a/1190000012536871
webpack目錄
- 第1課: 安裝webpack和webpack-dev-server
- 第2課: 配置文件
- 第3課: 做為node的一個模塊來使用
- 第4課: 插件篇
- 第5課: 模塊篇
- 第6課: 在Vue開發中使用webpack
本文參考文檔
- webpack官方安裝文檔 https://webpack.js.org/guides... 中文翻譯
- webpack-dev-server官方安裝文檔: https://webpack.js.org/guides...
- package.json官方詳解: https://docs.npmjs.com/files/...
- webpack命令行各參數的用法: https://webpack.js.org/api/cli/ 中文翻譯
- webpack-dev-server的配置 https://webpack.js.org/config... 中文翻譯
- 官方插件列表 插件中文翻譯 html-webpack-plugin插件托管地址和用法 html-loader托管地址和用法 file-loader托管地址和用法
- 官方網站1 官方網站2 官方文檔 官方教程 中文版本文檔
前提條件
- 電腦裝了一個全新的nodejs，最好是LTS版本,舊的nodejs版本可能沒使用webpack的新功能，也可能會丟失一些依賴的包
- 先安裝好淘寶的cnpm，淘寶鏡像方便些
- 我的安裝環境是win10
一：安裝webpack和webpack-dev-server
1.准備工作
- 新建項目文件夾
D:\03www2018\study\webpack2017下面簡寫為根目錄 - 新建npm配置文件package.josn,
根目錄>cnpm init
2.項目局部安裝webpack和webpack-dev-server
- 不建議全局安裝webpack和webpack-dev-server
- 局部安裝webpack
根目錄>cnpm i webpack -D - 局部安裝server
根目錄>cnpm i webpack-dev-server -D - 會自動生成node_modules文件夾,下有804個文件夾(485+319server)個文件夾，這些包都是webpack的依賴
- package.json中增加了剛安裝的包webpack的配置
"devDependencies": { "webpack": "^3.10.0", "webpack-dev-server": "^2.9.7" }說明1: devDependencies是開發依賴，只會在打包過程中用到，不會包含到最后的代碼中
說明2: 如果想安裝指定版本的webpack，使用npm install --save-dev webpack@<版本號>格式
3.熟悉webpack命令行各參數的意思
- 有關命令行各參數的用法，
根目錄>"node_modules/.bin/webpack" -h - 上面這個執行webpack很不方便，修改
根目錄>package.json，在script加上兩條
"scripts": { "a" :"webpack --config ./build/webpack.dev.conf.js", "b" :"webpack-dev-server --config ./build/webpack.dev.conf.js", "test": "echo \"Error: no test specified\" && exit 1" },- 命令行的選項其實都可以寫在配置文件webpack.config.js中，寫在配置文件中更方便更強大。webpack啟動時要讀取配置文件，參數--config指定讀取哪個配置文件，如果沒有使用--config指定，會默認在
根目錄中找webpack.config.js或webpackfile.js這個文件,有關配置文件的命名隨意定，但最好帶上環境，如webpack.base|dev|prod.conf.js
01: 配置選項 Config options:
--config 配置文件路徑，字符串格式，默認是`根目錄`下的 webpack.config.js 或 webpackfile.js， --config-name 使用配置的名字，字符串 --env 當配置文件輸出的是一個函數時，要指定，在下一節課中會介紹 02: 基本選項 Basic options: --context 入口文件根目錄，默認為當前目錄 --entry 入口文件,這里只能是字符串，但在配置文件中還可以定義數組或對象 --watch, -w 監視是否有文件有改動，會自動打包，默認為false --debug Switch loaders to debug mode [boolean] --devtool Enable devtool for better debugging experience (Example: --devtool eval-cheap-module-source-map) [string] -d shortcut for --debug --devtool eval-cheap-module-source-map --output-pathinfo [boolean] -p shortcut for --optimize-minimize --define process.env.NODE_ENV="production" [boolean] --progress Print compilation progress in percentage [boolean] 03: 模塊選項 Module options: --module-bind Bind an extension to a loader [string] --module-bind-post [string] --module-bind-pre [string] 04: 輸出選項 Output options: --output-path The output path for compilation assets [string] [default: The current directory] --output-filename The output filename of the bundle [string] [default: [name].js] --output-chunk-filename The output filename for additional chunks [string] [default: filename with [id] instead of [name] or [id] prefixed] --output-source-map-filename The output filename for the SourceMap [string] --output-public-path The public path for the assets [string] --output-jsonp-function The name of the jsonp function used for chunk loading [string] --output-pathinfo Include a comment with the request for every dependency (require, import, etc.) [boolean] --output-library Expose the exports of the entry point as library [string] --output-library-target The type for exposing the exports of the entry point as library [string] 05: 高級選項 Advanced options: --records-input-path Path to the records file (reading) [string] --records-output-path Path to the records file (writing) [string] --records-path Path to the records file [string] --define Define any free var in the bundle [string] --target The targeted execution environment [string] --cache Enable in memory caching [boolean] [default: It's enabled by default when watching] --watch-stdin, --stdin Exit the process when stdin is closed [boolean] --watch-aggregate-timeout Timeout for gathering changes while watching --watch-poll The polling interval for watching (also enable polling) [string] --hot Enables Hot Module Replacement [boolean] --prefetch Prefetch this request (Example: --prefetch ./file.js) [string] --provide Provide these modules as free vars in all modules (Example: --provide jQuery=jquery) [string] --labeled-modules Enables labeled modules [boolean] --plugin Load this plugin [string] --bail Abort the compilation on first error [boolean] [default: null] --profile Profile the compilation and include information in stats [boolean] [default: null] 06: 解析選項 Resolving options: --resolve-alias Setup a module alias for resolving (Example: jquery-plugin=jquery.plugin) [string] --resolve-extensions Setup extensions that should be used to resolve modules (Example: --resolve-extensions .es6,.js) [array] --resolve-loader-alias Setup a loader alias for resolving [string] 07: 優化選項 Optimizing options: --optimize-max-chunks Try to keep the chunk count below a limit --optimize-min-chunk-size Try to keep the chunk size above a limit --optimize-minimize Minimize javascript and switches loaders to minimizing [boolean] 08: 統計選項 Stats options: --color, --colors Enables/Disables colors on the console [boolean] [default: (supports-color)] --sort-modules-by Sorts the modules list by property in module [string] --sort-chunks-by Sorts the chunks list by property in chunk [string] --sort-assets-by Sorts the assets list by property in asset [string] --hide-modules Hides info about modules [boolean] --display-exclude Exclude modules in the output [string] --display-modules Display even excluded modules in the output [boolean] --display-max-modules Sets the maximum number of visible modules in output [number] --display-chunks Display chunks in the output [boolean] --display-entrypoints Display entry points in the output [boolean] --display-origins Display origins of chunks in the output [boolean] --display-cached Display also cached modules in the output [boolean] --display-cached-assets Display also cached assets in the output [boolean] --display-reasons Display reasons about module inclusion in the output [boolean] --display-depth Display distance from entry point for each module [boolean] --display-used-exports Display information about used exports in modules (Tree Shaking) [boolean] --display-provided-exports Display information about exports provided from modules [boolean] --display-optimization-bailout Display information about why optimization bailed out for modules [boolean] --display-error-details Display details about errors [boolean] --display Select display preset (verbose, detailed, normal, minimal, errors-only, none) [string] --verbose Show more details [boolean] 09: 選項 Options: --help, -h 顯示幫助信息 --version, -v 版本號 --json, -j 將結果以JSON格式顯示 4.准備項目文件夾及文件
為了更好地演示和學習webpack，請建好下列文件夾和文件
項目根目錄
│ package.json ├───node_modules │ └╌╌ 下面是npm包 ├───dist │ └╌╌╌╌╌logo.jpg ├───build │ ├╌╌╌╌╌ build.js │ ├╌╌╌╌╌ webpack.base.conf.js │ ├╌╌╌╌╌ webpack.dev.conf.js │ └╌╌╌╌╌ webpack.prod.conf.js ├───src │ ├╌╌╌╌╌ main.js │ └╌╌╌╌╌tmp │ ├╌╌╌╌╌home.js │ ├╌╌╌╌╌about.js │ └╌╌╌╌╌contact.js │ └╌╌╌╌╌template │ └╌╌╌╌╌daqi.html // 為hmtl插件的模板 │ └╌╌╌╌╌images │ └╌╌╌╌╌logo.jpg 先只需寫這幾個文件，后面會陸續補充
二：打包
准備配置文件
根目錄/build/webpack.dev.conf.js的內容如下，這是史上最簡單的配置文件了
module.exports = { entry: './src/main', //main.js中的.js可以省略，前面的./不能省 output:{ filename:'./dist/app.js' // dist文件夾不存在時，會自動創建 } }根目錄/src/main.js中隨便寫一句
console.log('hello,歡迎來到零和壹在線課堂')打包
D:\03www2018\study\webpack2017>npm run a,顯示如下
> webpack2017@1.0.0 a D:\03www2018\study\webpack2017 > webpack --config ./build/webpack.dev.conf.js Hash: 94dc0f2301921649904c // complication的hash值，它的長度和算法由output中相應的項決定 Version: webpack 3.10.0 // webpack的版本 Time: 55ms // 打包花費的時間 Asset Size Chunks Chunk Names ./dist/app.js 2.5 kB 0 [emitted] main //單個文件和數組的chunk名字默認為main [0] ./src/main.js 32 bytes {0} [built]打開打包后的文件看下,整體是一個自執行文件，每個文件是一個模塊做為自執行函數的參數
三：開啟服務器
先啟動看下，根目錄>npm run b
從啟動的信息中可以看到，它包含了上面的打包，項目的網址是http://localhost:8080/，可以在瀏覽器中打開看下效果，但由於沒有指定入口文件，所以會顯示當前目錄的內容,有一點必須明白，服務器打包的后的文件並沒有物理存在電腦上，只是在內存中，為了方便教程的講解，在這里先講下服務器的配置，有關全部配置的講解，請參考下一篇文章:配置文件詳解
3.1 使用HtmlWebpackPlugin插件生成首頁
首頁一般為一個html文件，我們到現在還沒有定義，為了方便，順便提前了解一下webpack的插件功能，我這里使用HtmlWebpackPlugin來生成首頁，插件的使用基本相同，分以下幾步
- 第一步安裝
根目錄>cnpm i -D html-webpack-plugin - 修改配置文件
根目錄/build/webpack.dev.conf.js
const path = require('path') const HtmlWebpackPlugin = require('html-webpack-plugin'); //第二步導入 module.exports = { entry: './src/main', //main.js中的js可以省略，前面的./不能省 output:{ filename:'./dist/[hash]app.js', hashDigestLength: 8 // 默認長度是20 }, plugins: [new HtmlWebpackPlugin], //第三步，實例化后放在plugins這個數組中就行 devServer: { contentBase: path.join(__dirname, "../dist"), //網站的根目錄為 根目錄/dist，如果配置不對，會報Cannot GET /錯誤 port: 9000, //端口改為9000 open:true // 自動打開瀏覽器，適合懶人 } }生成的html文件只在內存中，並沒有存在物理磁盤上，來看一下生成的內容,留心下生成的js文件中的hash值，它的長度是8位，就是上面hashDigestLength: 8定義的
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Webpack App</title> </head> <body> <script type="text/javascript" src="./dist/4e0c807aapp.js"></script></body> </html>html-webpack-plugin的用途
- 對於打包的文件名中有hash的，這個插件是必選，因為每次源文件修改，打包后的名字就不一樣
- 生成一個html5模板文件，可適用於lodash模板，也可以利用自己定義的加載器
- js注入，打包后的js文件會自動注入到html文件的body結尾部分(默認，也可以注入到head部分)
- css文件注入,假如你使用ExtractTextPlugin插件(這個插件也是必須要了解的)將css文件是單獨剝離出來，不放在html中的style標簽內，它會自動將css鏈接注入到link標簽中
html-webpack-plugin插件完整配置
const path = require('path') const HtmlWebpackPlugin = require('html-webpack-plugin'); const HtmlWebpackPluginConfig={ title: 'hello,零和壹在線課堂', // html5文件中<title>部分 filename: 'front.html', // 默認是index.html，服務器中設置的首頁是index.html，如果這里改成其它名字，那么devServer.index改為和它一樣，最終完整文件路徑是output.path+filename，如果filename中有子文件夾形式，如`./ab/cd/front.html`，只取`./front.html` template: './src/template/daqi.html', //如果覺得插件默認生成的hmtl5文件不合要求，可以指定一個模板，模板文件如果不存在，會報錯，默認是在項目根目錄下找模板文件，才模板為樣板，將打包的js文件注入到body結尾處 inject:head, // true|body|head|false，四種值，默認為true,true和body相同,是將js注入到body結束標簽前,head將打包的js文件放在head結束前,false是不注入，這時得要手工在html中加js } module.exports = { entry: './src/main', //main.js中的js可以省略，前面的./不能省 output:{ filename:'./dist/[hash]app.js', hashDigestLength: 8 }, plugins: [new HtmlWebpackPlugin(HtmlWebpackPluginConfig)], //先不配置插件，看看效果 devServer: { contentBase: path.join(__dirname, "../dist"), //網站的根目錄為 根目錄/dist port: 9000, //端口改為9000 open:true, // 自動打開瀏覽器 index:'front.html' // 與HtmlWebpackPlugin中配置filename一樣 } }3.2 devServer常用配置
const path = require('path') const HtmlWebpackPlugin = require('html-webpack-plugin'); const HtmlWebpackPluginConfig={ title: 'hello,零和壹在線課堂', // html5文件中<title>部分 filename: 'front.html', // 默認是index.html，服務器中設置的首頁是index.html，如果這里改成其它名字，那么devServer.index改為和它一樣 template: './src/template/daqi.html', // 如果覺得插件默認生成的hmtl5文件不合要求，可以指定一個模板，模板文件如果不存在，會報錯，默認是在項目根目錄下找模板文件，才模板為樣板，將打包的js文件注入到body結尾處 inject:'body', // true|body|head|false，四種值，默認為true,true和body相同,是將js注入到body結束標簽前,head將打包的js文件放在head結束前,false是不注入，這時得要手工在html中加js } module.exports = { entry: './src/main', //main.js中的js可以省略，前面的./不能省 output:{ filename:'./dist/[hash]app.js', hashDigestLength: 8 }, plugins: [new HtmlWebpackPlugin(HtmlWebpackPluginConfig)], //先不配置插件，看看效果 devServer: { contentBase: path.join(__dirname, "../dist"), //網站的根目錄為 根目錄/dist port: 9000, //端口改為9000 host: '192.168.0.103', //如果指定的host，這樣同局域網的電腦或手機可以訪問該網站,host的值在dos下使用ipconfig獲取 open:true, // 自動打開瀏覽器 index:'front.html', // 與HtmlWebpackPlugin中配置filename一樣 inline:true, // 默認為true, 意思是，在打包時會注入一段代碼到最后的js文件中，用來監視頁面的改動而自動刷新頁面,當為false時，網頁自動刷新的模式是iframe，也就是將模板頁放在一個frame中 hot:false, compress:true //壓縮 } }結合服務器和html插件，最后生成的配置文件如下
const path = require('path') const HtmlWebpackPlugin = require('html-webpack-plugin'); const webpack = require('webpack') const HtmlWebpackPluginConfig={ title: 'hello,零和壹在線課堂', // html5文件中<title>部分 filename: 'front.html', // 默認是index.html，服務器中設置的首頁是index.html，如果這里改成其它名字，那么devServer.index改為和它一樣 // 也是 context+template是最后模板的完整路徑，./不能少 template: './template/daqi.html', // 如果覺得插件默認生成的hmtl5文件不合要求，可以指定一個模板，模板文件如果不存在，會報錯，默認是在項目根目錄下找模板文件，才模板為樣板，將打包的js文件注入到body結尾處 inject:'body', // true|body|head|false，四種值，默認為true,true和body相同,是將js注入到body結束標簽前,head將打包的js文件放在head結束前,false是不注入，這時得要手工在html中加js } module.exports = { context: path.resolve(__dirname,'../src'), //D:\03www2018\study\webpack2017\build\src entry: './main', //main.js中的js可以省略，前面的./不能省 output:{ path:path.resolve(__dirname,'../dist'), filename: './[hash]app.js', hashDigestLength: 8 }, module: { rules: [ ] }, plugins: [ new HtmlWebpackPlugin(HtmlWebpackPluginConfig), // 生成首頁html5文件，外部插件需要安裝 new webpack.DefinePlugin({BJ: JSON.stringify('北京'),}) // 內置插件，無須安裝，可以理解為它是webpack實例的一個方法，該插件相當於apache等web服務器上定義一個常量 ], devServer: { contentBase: path.resolve(__dirname, "../dist"), //網站的根目錄為 根目錄/dist，這個路徑一般與output.path一致，因為html插件生成的html5頁是放在output.path這個目錄下 port: 9000, //端口改為9000 open:true, // 自動打開瀏覽器，每次啟動服務器會自動打開默認的瀏覽器 index:'front.html', // 與HtmlWebpackPlugin中配置filename一樣 inline:true, // 默認為true, 意思是，在打包時會注入一段代碼到最后的js文件中，用來監視頁面的改動而自動刷新頁面,當為false時，網頁自動刷新的模式是iframe，也就是將模板頁放在一個frame中 hot:false, compress:true //壓縮 } }3.3 給首頁加一張圖片
// D:\03www2018\study\webpack2017\src\template\daqi.html
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>大奇模板</title> </head> <body> <div style="background-color:#eee;font-size:16px;">歡迎來到零和壹在線課堂1234</div> <div id='hello'></div> <img src='/img/logo2.jpg' data-src='../images/logo.jpg' /> </body> </html>- webpack，通過使用
file-loader可以將圖片當成一個模塊，使用require來導入，進一步可以使用url-loader將圖片轉成base64-data - 使用圖片的場景大致分四種，html文件中使用src標簽，樣式的background中設定背景，js文件中元素.innerHTML='<img src="logo.jpg" />'的方式，最后一種是在vue或react等框架中使用，今天要講的是第一種，如何處理html文件src標簽中的圖片
- html文件中圖片的處理有兩種，一種是象正常使用圖片一樣，不打包，但圖片必須放在打包生成文件目錄下，如
./dist/logo.jpg，也就是最后的入口front.html文件可以讀到的位置，在front.html中使用<img src='./logo.jpg'/>,表示logo.jpg與最后生成的front.html是同級目錄。但實際工作中，往往圖片放在與打包前的html模板文件一起的，需要將圖片和html模板文件分別打包到./dist下，這使用html-loader是解決不了的，官網及網上大部分教程講得不是特別清楚，在這里我詳細講下，這里就要用到file-loader，否則會報錯Error: Child compilation failed: Module parse failed: Unexpected character '�' (1:0)You may need an appropriate loader to handle this file type.
第1步：安裝html-loader和file-loader,根目錄/cnpm i -D html-loader file-loader
file-loader處理require('./logo.jpg')這種類型，將圖片當成一個js模塊
html-loader是將html中src標簽中配置有特定data屬性的圖片，轉為由require的方式來導入。也就是說，它只是標識為哪些圖片需要由require的方式導入，但具體require導入，得需要file-loader插件，
第2步：在webpack.conf.js中配置這兩個加載器
module: { rules: [ { test: /\.html$/, use: { loader: 'html-loader', options: { attrs: [':data-src'] } } }, { test: /\.(png|jpg|gif)$/, use: [ { loader: 'file-loader', options: { //name: '[path][name].[ext]', name: '[name]2.[ext]', //最后生成的文件名是 output.path+ outputPaht+ name，[name],[ext],[path]表示原來的文件名字，擴展名，路徑 //useRelativePath:true, outputPath: 'img/' // 后面的/不能少 } } ] }, ] },第3步：在html文件src標簽中引用圖片<img src='/img/logo2.jpg' data-src='../images/logo.jpg' />
這里注意，data-src是打包前圖片位置，src是打包后圖片的url
四: 手機或其它電腦訪問該服務器
實際開發中，需要手機或其它設備如ipad即時訪問該服務器
服務器: 就是開啟webpack-dev-server這台電腦
其它設備：下面以同一網絡下的手機為例(同一wifi就行)
第一步：配置服務器
devServer: { contentBase: path.join(__dirname, "../dist"), //網站的根目錄為 根目錄/dist，如果配置不對，會報Cannot GET /錯誤 port: 9000, open: true, host: '192.168.0.103' //請在dos下，輸入ipconfig可以找到當前電腦的ip }第二步：在手機上找一個合適的瀏覽器，輸入 192.168.0.103:9000就可以訪問
說明：有少數瀏覽器打開是空白網頁，我使用uc瀏覽器ok，ip地址和端口與你自己的設置有關，我上面只是我的設置