webpack安裝配置及使用教程詳解
一、webpack介紹
1、由來
由於前端之前js、css、圖片文件需要單獨進行壓縮和打包,這樣團隊人員處理很繁瑣,然後 Instagram 團隊就想讓這些工作自動化,然後webpack應運而生。
2、介紹
webpack是一個模塊打包器(module bundler),webpack視HTML,JS,CSS,圖片等文件都是一種 資源 ,每個資源文件都是一個模塊(module)文件,webpack就是根據每個模塊文件之間的依賴關系將所有的模塊打包(bundle)起來。
3、作用
- 對 CommonJS 、 AMD 、ES6的語法做瞭兼容
- 對js、css、圖片等資源文件都支持打包(適合團隊化開發)
- 比方你寫一個js文件,另外一個人也寫一個js文件,需要合並很麻煩,現在交給webpack合並很簡單
- 有獨立的配置文件webpack.config.js
- 可以將代碼切割成不同的chunk,實現按需加載,降低瞭初始化時間
- 具有強大的Plugin(插件)接口,大多是內部插件,使用起來比較靈活
- ……
4、拓展說明
CommonJS、AMD、CMD是用於JavaScript模塊管理的三大規范,CommonJS定義的是模塊的同步加載,是一個更偏向於服務器端的規范(也可以在瀏覽器中使用),主要用於Nodejs,根據CommonJS規范,一個單獨的文件就是一個模塊,加載模塊使用require()方法,該方法讀取一個文件並執行,最後返回文件內部的exports對象。
AMD和CMD則是定義模塊異步加載適用於瀏覽器端,都是為瞭 JavaScript 的模塊化開發,(這裡說一下為什要有異步加載,因為瀏覽器如果使用common.js同步加載模塊的話,就會導致性能等問題,所以針對這個問題,又出瞭一個規范,這個規范可以實現異步加載依賴模塊)
AMD規范會提前加載依賴模塊,AMD規范是通過requireJs 在推廣過程中對模塊定義的規范化產出。
(AMD 規范:https://github.com/amdjs/amdjs-api/wiki/AMD)
CMD規范會延遲加載依賴模塊, CMD 規范是 SeaJs 在推廣過程中對模塊定義的規范化產出。
(CMD規范:https://github.com/seajs/seajs/issues/242)
AMD規范和CMD規范的區別
- 對於依賴的模塊,AMD 是提前執行,CMD 是延遲執行。不過 RequireJS 從 2.0 開始,也改成可以延遲執行(根據寫法不同,處理方式不同)
- CMD 推崇依賴就近,AMD 推崇依賴前置
- AMD 的 API 默認是一個當多個用,CMD 的 API 嚴格區分,推崇職責單一。比如 AMD 裡,require 分全局 require 和局部 require,都叫 require。CMD 裡,沒有全局 require,而是根據模塊系統的完備性,提供 seajs.use 來實現模塊系統的加載啟動。CMD 裡,每個 API 都簡單純粹
webpack和gulp的區別
- gulp是前端自動化構建工具,強調的是前端開發的工作流程,我們可以通過配置一系列的task,定義task處理的事情(代碼壓縮、合並、編譯、瀏覽器實時更新等),然後定義執行順序,來讓gulp執行這些task,從而構建項目的整個前端開發流程,自動化構建工具並不能把所有模塊打包到一起,也不能構建不同模塊之間的依賴關系。
- webpack是 JavaScript 應用程序的模塊打包器,強調的是一個前端模塊化方案,更側重模塊打包,我們可以把開發中的所有資源(圖片、js文件、css文件等)都看成模塊,通過loader(加載器)和plugins(插件)對資源進行處理,打包成符合生產環境部署的前端資源。
5、webpack整體認知
(1)、webpack的核心概念分為 入口(Entry)、加載器(Loader)、插件(Plugins)、出口(Output);
- 入口(Entry):入口起點告訴 webpack 從哪裡開始,並根據依賴關系圖確定需要打包的文件內容
- 加載器(Loader):webpack 將所有的資源(css, js, image 等)都看做模塊,但是 webpack 能處理的隻是 JavaScript,因此,需要存在一個能將其他資源轉換為模塊,讓 webpack 能將其加入依賴樹中的東西,它就是 loader。loader用於對模塊的源代碼進行轉換。loader 可以使你在 import 或"加載"模塊時預處理文件。因此,loader 類似於其他構建工具中“任務(task)”,並提供瞭處理前端構建步驟的強大方法。
rules: [ { test: /\.(js|jsx)$/, use: 'babel-loader' } ]
插件(Plugins):loader 隻能針對某種特定類型的文件進行處理,而 plugin 的功能則更為強大。在 plugin 中能夠介入到整個 webpack 編譯的生命周期,Plugins用於解決 loader 無法實現的其他事情,也就是說loader是預處理文件,那plugin 就是後處理文件。
對loader打包後的模塊文件(bundle.js)進行二次優化處理,例如:代碼壓縮從而減小文件體積
提供輔助開發的作用:例如:熱更新(瀏覽器實時顯示)
plugins: [ new webpack.optimize.UglifyJsPlugin(), new HtmlWebpackPlugin({template: './src/index.html'}) ]
二、webpack安裝
1、安裝node
使用 node -v 命令檢查版本
2、安裝cnpm
https://npmmirror.com/
npm install -g cnpm --registry=https://registry.npm.taobao.org
使用 cnpm -v 命令檢查版本
3、安裝nrm的兩種方法
https://www.npmjs.com/package/nrm
nrm可以幫助我們切換不同的NPM源的快捷開關,可以切換的NPM源包括:npm,cnpm,taobao, rednpm, npmMirror , edunpm
#第一種方法(由於是外網訪問進行安裝,可能會被墻) npm install -g nrm
#第二種方法(國內的淘寶鏡像,訪問穩定,推薦) cnpm install -g nrm
- 使用 nrm – V 命令檢查版本(註意這裡的 V 是大寫的)
- 使用nrm ls 命令可以查看當前可以可以切換的 NPM源
- 使用 npm use cnpm 命令 指定要使用的哪種NPM源
4、安裝webpack
全局安裝
npm install --global webpack
在項目中安裝最新版本或特定版本,分別執行以下命令:
npm install --save-dev webpack npm install --save-dev webpack@<version>
三、webpack配置
搭建項目結構
webpack(項目總目錄)
dist
src
js
moudle1.js
function sum(x,y){ return x + y; } // 導出 sum 函數 module.exports = sum;
main.js
// 1、獲取index.html中的dom對象 var first = document.getElementById('first'); var btn = document.getElementById('btn'); var two = document.getElementById('two'); var res = document.getElementById('res'); btn.onclick = function(){ var firstValue = parseFloat(first.value); var twoValue = parseFloat(two.value); //2、獲取 module1.js中的 sum函數 //http://www.ruanyifeng.com/blog/2015/05/require.html var sum = require('./module1.js'); res.value = sum(firstValue,twoValue); }
index.html
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Document</title> </head> <body> <input type="text" id="first"> <input type="button" id="btn" value="+"> <input type="text" id="two"> <input type="button" id="btn" value="="> <input type="text" id="res"> <script src="./dist/js/bulid.js"></script> </body> </html>
webpack.config.js(手動創建)
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // module.exports = { entry:'./src/./js/main.js', // 指定入口文件 output:{ path: path.resolve(__dirname, './dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 },
1、初始化一個項目(會創建一個package.json文件)
npm init
2、在當前的項目中安裝Webpack作為依賴包
npm install --save-dev webpack
說明:
–save :將配置信息保存到package.json中,
同時 –save :也是項目生產環境,項目發佈之後還依賴的東西,保存在dependencies
例如:如果你用瞭 jQuery,由於發佈之後還是依賴jQuery,所以是dependencies
–save-dev :是項目開發環境依賴的東西,保存在devDependencies中
例如:寫 ES6 代碼,如果你想編譯成 ES5 發佈那麼 babel 就是devDependencies
3、當前項目結構
4、實現CSS打包
npm install css-loader style-loader --save-dev #或者 cnpm install css-loader style-loader --save-dev
在src—>css目錄中新建main.css
#first{ border: 1px solid red; }
在webpack.config.js中配置相關的loader
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // module.exports = { entry:'./src/./js/main.js', // 指定入口文件 output:{ path: path.resolve(__dirname, './dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 }, module:{ rules:[ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 } ] } }
在main.js中獲取css目錄中的main.css文件
// 1、獲取index.html中的dom對象 var first = document.getElementById('first'); var btn = document.getElementById('btn'); var two = document.getElementById('two'); var res = document.getElementById('res'); btn.onclick = function(){ var firstValue = parseFloat(first.value); var twoValue = parseFloat(two.value); //2、獲取 module1.js中的 sum函數 //http://www.ruanyifeng.com/blog/2015/05/require.html var sum = require('./module1.js'); res.value = sum(firstValue,twoValue); } // 3、獲取css目錄中的main.css文件 require('../css/main.css');
在終端中輸入 webpack命令進行css文件打包
5、實現SCSS打包
在src目錄中新建 sass目錄–> scss1.scss
// scss1.scss文件 $color:purple; #two{ border:1px solid $color; }
安裝對應的loader
npm install sass-loader node-sass webpack --save-dev
或者
cnpm install sass-loader css-loader style-loader node-sass webpack --save-dev
在webpack.config.js中配置相關的loader
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // module.exports = { entry:'./src/./js/main.js', // 指定入口文件 output:{ path: path.resolve(__dirname, './dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 }, module:{ rules:[ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 // 實現 css 打包 { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 }, { test: /\.scss$/, // 註意 是sass-loader ,不是 scss-loader use: [ 'style-loader', 'css-loader', 'sass-loader' ] } ] } }
在js目錄中 main.js裡面引入 scss1.scss
// 1、獲取index.html中的dom對象 var first = document.getElementById('first'); var btn = document.getElementById('btn'); var two = document.getElementById('two'); var res = document.getElementById('res'); btn.onclick = function(){ var firstValue = parseFloat(first.value); var twoValue = parseFloat(two.value); //2、獲取 module1.js中的 sum函數 //http://www.ruanyifeng.com/blog/2015/05/require.html var sum = require('./module1.js'); res.value = sum(firstValue,twoValue); } // 3、獲取css目錄中的main.css文件 require('../css/main.css'); // 4、獲取sass目錄中的scss1.scss文件 require('../sass/scss1.scss');
在終端中輸入 webpack命令進行scss文件打包
6、實現Less打包
安裝
cnpm install --save-dev
cnpm install less less-loder css-loader style-loader webpack --save-dev
或者
cnpm install less-loader less --save-dev在webpack.config.js中配置相關的loader
在在src目錄中新建less目錄–> less1.less
-
@color:blue; #res{ border:1px dashed blue; }
在webpack.config.js中配置相關的loader
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // module.exports = { entry:'./src/./js/main.js', // 指定入口文件 output:{ path: path.resolve(__dirname, './dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 }, module:{ rules:[ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 // 實現 css 打包 { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 }, // 實現 scss 打包 { test: /\.scss$/, // 註意 是sass-loader ,不是 scss-loader use: [ 'style-loader', 'css-loader', 'sass-loader' ] }, // 實現 less 打包 { test: /\.less$/, use: [ 'style-loader', 'css-loader', 'less-loader' ] } ] } }
在js目錄中 main.js裡面引入 less1.less文件
// 5、獲取less目錄中的less1.less文件 require('../less/less1.less');
7、實現打包url資源(圖片、gif、圖標等)功能
在src 目錄中 新建imgs目錄,放入兩張不同大小的圖片
在index.html中新增 <div id="bg1"></div> <div id="bg2"></div>
在mian.css中新增
// mian.css文件 #bg1{ width: 200px; height: 200px; background: url('../imgs/bxg.jpg'); } #bg2{ width: 200px; height: 200px; background: url('../imgs/web.jpg') no-repeat; }
使用註意事項
1.如果我們希望在頁面引入圖片(包括img的src和background的url)。當我們基於webpack進行開發時,引入圖片會遇到一些問題。
2. 其中一個就是引用路徑的問題。拿background樣式用url引入背景圖來說,我們都知道,webpack最終會將各個模塊打包成一個文件,因此我們樣式中的url路徑是相對入口html頁面的,而不是相對於原始css文件所在的路徑的。這就會導致圖片引入失敗。這個問題是用file-loader解決的,file-loader可以解析項目中的url引入(不僅限於css),根據我們的配置,將圖片拷貝到相應的路徑,再根據我們的配置,修改打包後文件引用路徑,使之指向正確的文件。
3. 另外,如果圖片較多,會發很多http請求,會降低頁面性能。這個問題可以通過url-loader解決。url-loader會將引入的圖片編碼,生成dataURl。相當於把圖片數據翻譯成一串字符。再把這串字符打包到文件中,最終隻需要引入這個文件就能訪問圖片瞭。當然,如果圖片較大,編碼會消耗性能。因此url-loader提供瞭一個limit參數,小於limit字節的文件會被轉為DataURl,大於limit的還會使用file-loader進行copy。
4. url-loader和file-loader是什麼關系呢?簡答地說,url-loader封裝瞭file-loader。url-loader不依賴於file-loader,即使用url-loader時,隻需要安裝url-loader即可,不需要安裝file-loader,因為url-loader內置瞭file-loader。通過上面的介紹,我們可以看到,url-loader工作分兩種情況:
- 1.文件大小小於limit參數,url-loader將會把文件轉為DataURL;
- 2.文件大小大於limit,url-loader會調用file-loader進行處理,參數也會直接傳給file-loader。因此我們隻需要安裝url-loader即可。
安裝
cnpm install
cnpm install url-loader file-loader --save-dev
在webpack.config.js中配置相關的loader
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // module.exports = { entry:'./src/./js/main.js', // 指定入口文件 output:{ path: path.resolve(__dirname, './dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 publicPath:'dist/' // path:所有輸出文件的目標路徑; // publicPath:輸出解析文件的目錄,url 相對於 HTML 頁面 }, module:{ rules:[ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 // 實現 css 打包 { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 }, // 實現 scss 打包 { test: /\.scss$/, // 註意 是sass-loader ,不是 scss-loader use: [ 'style-loader', 'css-loader', 'sass-loader' ] }, // 實現 less 打包 { test: /\.less$/, use: [ 'style-loader', 'css-loader', 'less-loader' ] }, // 實現 url 資源打包 { // 圖片和字體文件使用 url-loader 來處理 test: /\.(png|jpg|gif|ttf|eot|woff|woff2|svg)$/, use: [ { loader: 'url-loader', // options 為可以配置的選項 options: { limit: 8192 // limit=8192表示將所有小於8kb的圖片都轉為base64形式(為什麼 呢?因為一個很小的圖片,不值當的去發送一個請求,減少請求次 數。) // (其實應該說超過8kb的才使用 url-loader 來映射到文件,否 則轉為dataurl形式) } } ] //保證輸出的圖片名稱與之前命名的圖片名稱保持一致(目前隻是支持這樣的寫法, webpack3 沒有響應的options進行配置) // use:'url-loader?limit=8192&name=imgs/[name].[ext]' } ] } }
在main.js中引入mui目錄中icons-extra.css的文件
// 5、獲取less目錄中的less1.less文件 require('../less/less1.less'); // 6、獲取src目錄中的mui目錄中icons-extra.css的文件 require('../mui/css/icons-extra.css');
8、Webpack-dev-server結合後端服務器的熱替換配置
webpack-dev-server提供瞭一個簡單的 web 服務器,並且能夠實時重新加載(live reloading),同時把生成好的js和html構建到我們的電腦內存中,這樣的話,即使我們的目錄中沒有瞭相關js等文件,還能夠加載出來,這樣能夠提高我們頁面運行速度。
安裝 webpack-dev-server 插件
#先把之前依賴的包安裝 cnpm install
cnpm install webpack-dev-server --save-dev
// webpack.config.js const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 module.exports = { entry:'./src/./js/main.js', // 指定入口文件 output:{ path: path.resolve(__dirname, 'dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 }, module:{ rules:[ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 // 實現 css 打包 { test: /\.css$/, use: [ 'style-loader', 'css-loader' ] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 }, // 實現 scss 打包 { test: /\.scss$/, // 註意 是sass-loader ,不是 scss-loader use: [ 'style-loader', 'css-loader', 'sass-loader' ] }, // 實現 less 打包 { test: /\.less$/, use: [ 'style-loader', 'css-loader', 'less-loader' ] }, // 實現 url 資源打包 { // 圖片文件使用 url-loader 來處理 test: /\.(png|jpg|gif|ttf)$/, use: [ { loader: 'url-loader', // options 為可以配置的選項 options: { limit: 8192 // limit=8192表示將所有小於8kb的圖片都轉為base64形式 // (其實應該說超過8kb的才使用 url-loader 來映射到文件,否則轉為data url形式) } } ] } ] }, devServer: { // contentBase: './dist', // 在 localhost:8080(默認) 下建立服務,將 dist 目錄下的文件,作為可訪問文件 contentBase:告訴服務器從哪裡提供內容 // 或者通過以下方式配置 contentBase: path.join(__dirname, "dist"), compress: true, // 當它被設置為true的時候對所有的服務器資源采用gzip壓縮 // 對JS,CSS資源的壓縮率很高,可以極大得提高文件傳輸的速率,從而提升web性能 port: 9000, // 如果想要改端口,可以通過 port更改 hot: true, // 啟用 webpack 的模塊熱替換特性() inline: true, // 實現實時重載(實現自動刷新功能)默認情況下是 true。 host: "localhost" // 如果你希望服務器外部可訪問,指定使用一個 host。默認是 localhost(也就是你可以不寫這個host這個配置屬性)。 } }
// package.json { "name": "mywebpack", "version": "1.0.0", "description": "", "main": "webpack.config.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", "start": "webpack-dev-server --open" // "start": "webpack-dev-server --open --port 8080 --hot --inline" // 如果在這裡配置瞭,就不用在webpack.config.js中配置devServer屬性瞭。 }, "author": "", "license": "ISC", "devDependencies": { "css-loader": "^0.28.7", "file-loader": "^1.1.5", "html-webpack-plugin": "^2.30.1", "less": "^3.0.0-alpha.3", "less-loader": "^4.0.5", "node-sass": "^4.5.3", "sass-loader": "^6.0.6", "style-loader": "^0.19.0", "url-loader": "^0.6.2", "webpack": "^3.8.1", "webpack-dev-server": "^2.9.3" } } ``` - 在命令行中運行 `npm start`,就會看到瀏覽器自動加載頁面。如果現在修改和保存任意源文件,web 服務器就會自動重新加載編譯後的代碼,但是打開後發現,打開的是 dist目錄,我們想要的是 index.html顯示我們的頁面,所以這是我們還要借助裡另一個 `html-webpack-plugin` 插件。
html-webpack-plugin 簡單創建 HTML 文件,用於服務器訪問,其中包括使用script標簽的body中的所有webpack包。
安裝 html-webpack-plugin 插件
cnpm install --save-dev html-webpack-plugin
webpack.config.js配置
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // 引入html-webpack-plugin 插件 const HtmlWebpackPlugin = require('html-webpack-plugin'); const webpack = require('webpack'); module.exports = { entry: './src/./js/main.js', // 指定入口文件 output: { path: path.resolve(__dirname, 'dist/js'), // 指定出口文件的路徑目錄 filename: 'bulid.js' // 制定出口文件的名稱 }, module: { rules: [ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 // 實現 css 打包 { test: /\.css$/, use: ['style-loader', 'css-loader'] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 }, // 實現 scss 打包 { test: /\.scss$/, // 註意 是sass-loader ,不是 scss-loader use: ['style-loader', 'css-loader', 'sass-loader'] }, // 實現 less 打包 { test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] }, // 實現 url 資源打包 { // 圖片文件使用 url-loader 來處理 test: /\.(png|jpg|gif|ttf)$/, use: [{ loader: 'url-loader', // options 為可以配置的選項 options: { limit: 8192 // limit=8192表示將所有小於8kb的圖片都轉為base64形式 // (其實應該說超過8kb的才使用 url-loader 來映射到文件,否則轉為data url形式) } }] } ] }, devServer: { // contentBase: './dist', // 在 localhost:8080(默認) 下建立服務,將 dist 目錄下的文件,作為可訪問文件 contentBase:告訴服務器從哪裡提供內容 // 或者通過以下方式配置 contentBase: path.join(__dirname, "dist"), port: 9000, // 如果想要改端口,可以通過 port更改 hot: true, // 啟用 webpack 的模塊熱替換特性() inline: true, // 實現實時重載(實現自動刷新功能)默認情況下是 true。 host: "localhost" // 如果你希望服務器外部可訪問,指定使用一個 host。默認是 localhost(也就是你可以不寫這個host這個配置屬性)。 }, plugins: [ new HtmlWebpackPlugin({ title: '首頁', // 用於生成的HTML文檔的標題 filename: 'index.html', //寫入HTML的文件。默認為index.html。也可以指定一個子目錄(例如:)assets/admin.html template: 'index.html' // Webpack需要模板的路徑 }), new webpack.HotModuleReplacementPlugin() // 需要結合 啟用熱替換模塊(Hot Module Replacement),也被稱為 HMR ] }
再次使用npm start命令就可以實現瀏覽器自動更新。
問題來瞭,HtmlWebpackPlugin中的 title並沒有顯示出來,原因是需要在定義的template模板中使用ejs語法,
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- EJS 語法 /* EJS是一個簡單高效的模板語言,通過數據和模板,可以生成HTML標記文本。可以說EJS是一個JavaScript庫,EJS可以同時運行在客戶端和服務器端,客戶端安裝直接引入文件即可 */ --> <title><%= htmlWebpackPlugin.options.title%></title> </head> <body> <input type="text" id="first"> <input type="button" id="btn" value="+"> <input type="text" id="two"> <input type="button" id="btn" value="="> <input type="text" id="res"> <div id="bg1"></div> <div id="bg2"></div> </body> </html>
再次使用npm start命令就可以啦。
9、ES6轉換為ES5語法
安裝
cnpm install --save-dev babel-loader babel-core babel-preset-env
babel-core如果某些代碼需要調用Babel的API進行轉碼,就要使用babel-core模塊
babel-preset-env通過根據您的目標瀏覽器或運行時環境自動確定您需要的Babel插件
babel 對一些公共方法使用瞭非常小的輔助代碼,比如 _extend。 默認情況下會被添加到每一個需要它的文件中,你可以引入 babel runtime 作為一個獨立模塊,來避免重復引入。
你必須執行 npm install babel-plugin-transform-runtime –save-dev 來把它包含到你的項目中
也要使用 npm install babel-runtime –save 把 babel-runtime 安裝為一個依賴
配置
// 實現 url 資源打包 { // 圖片文件使用 url-loader 來處理 test: /\.(png|jpg|gif|ttf)$/, use: [{ loader: 'url-loader', // options 為可以配置的選項 options: { limit: 8192 // limit=8192表示將所有小於8kb的圖片都轉為base64形式 // (其實應該說超過8kb的才使用 url-loader 來映射到文件,否則轉為data url形式) } }] }, // 實現 ES6轉 ES5 { test: /\.js$/, exclude: /(node_modules)/, // exclude 排除的意思,把 node_modules文件夾排除編譯之外 use: { loader: 'babel-loader', options: { // presets 預設列表(一組插件)加載和使用 presets: ['env'], plugins: ['transform-runtime'] // 加載和使用的插件列表 } } }
把一些代碼改成ES6 語法的寫法
- ```js // main.js // 1、獲取index.html中的dom對象 var first = document.getElementById('first'); var btn1 = document.getElementById('btn1'); var two = document.getElementById('two'); var res = document.getElementById('res'); console.log(1); btn1.onclick = function() { var firstValue = parseFloat(first.value); var twoValue = parseFloat(two.value); //2、獲取 module1.js中的 sum函數 //http://www.ruanyifeng.com/blog/2015/05/require.html console.log(2); /* var sum = require('./module1.js'); res.value = sum(firstValue,twoValue);*/ res.value = sumObj.sum(firstValue, twoValue); } // 3、獲取css目錄中的main.css文件 // require('../css/main.css'); // 把步驟3 改為 ES6寫法,引入css目錄中的main.css文件 import '../css/main.css'; // 4、獲取sass目錄中的scss1.scss文件 require('../sass/scss1.scss'); // 5、獲取less目錄中的less1.less文件 require('../less/less1.less'); // 6、獲取src目錄中的mui目錄中icons-extra.css的文件 require('../mui/css/icons-extra.css'); // 把 var sum = require('./module1.js'); 寫成 ES6語法 import sumObj from './module1.js' ```
// moudule1.js function sum(x,y){ return x + y; } // 導出 sum 函數 // module.exports = sum; // 改成ES6 的寫法語法 export default{ sum }
10、防止文件緩存(生成帶有20位的hash值的唯一文件)
// webpack.config.js output: { path: path.resolve(__dirname, 'dist/js'), // 指定出口文件的路徑目錄 // filename: 'bulid.js' // 制定出口文件的名稱 filename: '[name].[hash].js' // 將入口文件重命名為帶有20位的hash值的唯一文件 }
11、抽取CSS為單獨文件
安裝插件從 build.js文件中提取文本(CSS)到單獨的文件
npm install --save-dev extract-text-webpack-plugin
在webpack.config.js中配置
const path = require('path'); // 首先要引入node.js中path 模塊,用於處理文件與目錄的路徑 // const 命令聲明一個隻讀的常量,一旦聲明,值不可以改變,改變會報錯;隻聲明不賦值也會報錯 // 常量存儲的是一個不可以變化的變量。 // 引入html-webpack-plugin 插件 const HtmlWebpackPlugin = require('html-webpack-plugin'); const webpack = require('webpack'); const ExtractTextPlugin = require("extract-text-webpack-plugin"); module.exports = { entry: './src/./js/main.js', // 指定入口文件 output: { path: path.resolve(__dirname, 'dist'), // 指定出口文件的路徑目錄 // filename: 'bulid.js' // 制定出口文件的名稱 // path指定瞭本地構建地址,publicPath指定在瀏覽器中所引用的,指定的是構建後在html裡的路徑 // publicPath: './', // 將入口文件重命名為帶有20位的hash值的唯一文件 filename: '[name].[hash].js' }, module: { rules: [ // 在webpack2中,loaders 被替換成瞭 rules 其實就是loader的規則 // 實現 css 打包 /*{ test: /\.css$/, use: ['style-loader', 'css-loader'] // test 說明瞭當前 loader 能處理那些類型的文件 // use 則指定瞭 loader 的類型。 // 註意:數組中的loader不能省略擴展名 },*/ // 實現 scss 打包 { test: /\.scss$/, // 註意 是sass-loader ,不是 scss-loader use: ['style-loader', 'css-loader', 'sass-loader'] }, // 實現 less 打包 { test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'] }, // 實現 url 資源打包 { // 圖片文件使用 url-loader 來處理 test: /\.(png|jpg|gif|ttf)$/, use: [{ loader: 'url-loader', // options 為可以配置的選項 options: { limit: 8192 // limit=8192表示將所有小於8kb的圖片都轉為base64形式 // (其實應該說超過8kb的才使用 url-loader 來映射到文件,否則轉為data url形式) } }] //保證輸出的圖片名稱與之前命名的圖片名稱保持一致(目前隻是支持這樣的寫法, webpack3 沒有響應的options進行配置) // use:'url-loader?limit=8192&name=imgs/[name].[ext]' }, // 實現 ES6轉 ES5 { test: /\.js$/, exclude: /(node_modules)/, // exclude 排除的意思,把 node_modules文件夾排除編譯之外 use: { loader: 'babel-loader', options: { // presets 預設列表(一組插件)加載和使用 presets: ['env'], plugins: ['transform-runtime'] // 加載和使用的插件列表 } } }, // 提取 css模塊(如果使用這個模塊的話,需要把之前的CSS打包模塊註釋掉,不然會重復) { test: /\.css$/, use: ExtractTextPlugin.extract({ fallback: "style-loader", use: "css-loader" }) } ] }, devServer: { // contentBase: './dist', // 在 localhost:8080(默認) 下建立服務,將 dist 目錄下的文件,作為可訪問文件 contentBase:告訴服務器從哪裡提供內容 // 或者通過以下方式配置 contentBase: path.join(__dirname, "dist"), port: 9000, // 如果想要改端口,可以通過 port更改 hot: true, // 啟用 webpack 的模塊熱替換特性() inline: true, // 實現實時重載(實現自動刷新功能)默認情況下是 true。 host: "localhost" // 如果你希望服務器外部可訪問,指定使用一個 host。默認是 localhost(也就是你可以不寫這個host這個配置屬性)。 }, plugins: [ // 從 bundle 中提取文本(CSS)到單獨的文件 new ExtractTextPlugin({ // 提取css,並重名為帶有 20位的hash值的唯一文件 filename: '[name].[hash].css', // 將所有的獨立文件模塊(這裡指的是css文件)合並成一個文件 allChunks: true }), new HtmlWebpackPlugin({ title: '首頁', // 用於生成的HTML文檔的標題 filename: 'index.html', //寫入HTML的文件。默認為index.html。也可以指定一個子目錄(例如:)assets/admin.html template: 'index.html' // Webpack需要模板的路徑 // template: 'index.ejs' // Webpack需要模板的路徑 }), // 需要結合webpack-dev-server 啟用熱替換模塊(Hot Module Replacement),也被稱為 HMR new webpack.HotModuleReplacementPlugin() ] }
12、開發環境和生產環境的分離
(1)開發環境與生產環境分離的原因如下:
- 在開發環境中,我們使用熱更新插件幫助我們實現瀏覽器的自動更新功能,我們的代碼沒有進行壓縮,如果壓縮瞭不方便我們調試代碼等等,所以以上這些代碼不應出現在生產環境中。
- 生產環境中,我們把項目部署到服務器時,我們會對代碼進行各種各樣的優化,比如壓縮代碼等等,這時候我們不應該把這些代碼放到開發環境中,不利於代碼開發和調試。
總結:針對以上這些說明,我們很有必要把區分開發環境與生產環境分離。
(2)開發環境的配置和生產換環境配置的區別。
- 開發環境有的配置,生產環境不一定有,比如說熱更新時使用到的HotModuleReplacementPlugin。
- 生產環境有的配置,開發環境不一定有,比如說用來壓縮js用的UglifyJsPlugin。
如何去做?
1> 因為webpack 默認找的是 webpack.config.js配置文件,所以要把開發環境的webpack.config.js配置文件改為webpack.dev.config.js代表開發環境的配置文件。
2> 新建一個webpack.prod.config.js,再把開發環境中的webpack.config.js復制進去(沒用的配置文件該刪除的刪除)
3> 修改package.json文件(在scripts 標簽中添加"dev"和"prod" 屬性配置)
"scripts": { "test": "echo \"Error: no test specified\" && exit 1", "dev": "webpack --config webpack.dev.config.js", "prod": "webpack --config webpack.prod.config.js" },
怎樣執行命令
執行開發環境的中配置
npm run dev
執行生產環境的中配置
npm run prod
13、在生產環境中配置代碼壓縮功能
配置webpack.prod.config.js 文件
// webpack.prod.config.js var UglifyJsPlugin = webpack.optimize.UglifyJsPlugin; // …… plugins: [ // …… // js代碼 壓縮 new UglifyJsPlugin({ compress: { warnings: false } }) ]
執行 npm run prod 命令
四、webpack1和webpack2的區別
webpack1.0已經廢棄使用,建議使用webpack2.0+
1、resolve.modulesDirectories 被重命名為 resolve.modules
2、module.loaders 將繼續支持,但在未來它將被module.rules 替換。
以上就是webpack安裝配置及使用教程詳解的詳細內容,更多關於webpack安裝配置教程的資料請關註WalkonNet其它相關文章!
推薦閱讀:
- webpack搭建vue環境時報錯異常解決
- 使用webpack手動搭建vue項目的步驟
- 使用webpack打包ts代碼的實現
- JavaScript webpack5配置及使用基本介紹
- 在vue項目中引入scss並使用scss樣式詳解