1.初始化
npm init -y
這個命令會創建一個默認的package.json。它包含了項目的一些配置參數,通過它可以進行初始安裝。詳細參數:https://docs.npmjs.com/files/package.json。
不要y參數的話,會在命令框中設置各項參數,但覺得沒啥必要。
2.安裝webpack
npm install webpack --save-dev
3.目錄結構

export default function () { var element = document.createElement('h1'); element.innerHTML = 'Hello world'; return element; }
component.js 是輸出一個內容為h1元素。export default 是ES6語法,表示指定默認輸出。import的時候不用帶大括號。
import component from './component'; document.body.appendChild(component());
index.js 的作用就是引用Component模塊,並在頁面上輸出一個h1元素。但完成這個還需要一個插件,因為目前我們還沒有index.html文件。
npm install html-webpack-plugin --save-dev
4.設置 webpack 配置文件
const path = require('path'); const HtmlWebpackPlugin = require('html-webpack-plugin'); const PATHS = { app: path.join(__dirname, 'app'), build: path.join(__dirname, 'build'), }; module.exports = { entry: { app: PATHS.app, }, output: { path: PATHS.build, filename: '[name].js', }, plugins: [ new HtmlWebpackPlugin({ title: 'Webpack demo', }), ], };
第一次看到這個配置文件是有點懵,主要是exports,分三個部分,一個入口,一個輸出,一個插件。入口指向了app文件夾。默認會把包含"index.js"的文件作為入口。輸出指定了build地址和一個文件名;[name]這兒表示占位符,可以看成webpack提供的一個變量。這個具體后面再看。而HtmlWebpackPlugin會生成一個默認的html文件。
5.打包
這個輸出包含了Hash(每次打包值都不同),Version,Time(耗時)。以及輸出的文件信息。 這時打開build文件夾,發現多了一個app.js和index.html文件,雙擊index.html:

{ "name": "Html5", "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "build": "webpack" }, "keywords": [], "author": "", "license": "ISC", "devDependencies": { "html-webpack-plugin": "^2.28.0", "webpack": "^2.2.1" } }
指定build。在cmd中執行npm run build 得到同樣的結果
<!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Webpack demo</title> </head> <body> <script type="text/javascript" src="app.js"></script></body> </html>
默認引用了app.js。
6、解析
app.js

/******/ (function(modules) { // webpackBootstrap /******/ // The module cache /******/ var installedModules = {}; /******/ // The require function /******/ function __webpack_require__(moduleId) { /******/ // Check if module is in cache /******/ if(installedModules[moduleId]) /******/ return installedModules[moduleId].exports; /******/ // Create a new module (and put it into the cache) /******/ var module = installedModules[moduleId] = { /******/ i: moduleId, /******/ l: false, /******/ exports: {} /******/ }; /******/ // Execute the module function /******/ modules[moduleId].call(module.exports, module, module.exports, __webpack_require__); /******/ // Flag the module as loaded /******/ module.l = true; /******/ // Return the exports of the module /******/ return module.exports; /******/ } /******/ // expose the modules object (__webpack_modules__) /******/ __webpack_require__.m = modules; /******/ // expose the module cache /******/ __webpack_require__.c = installedModules; /******/ // identity function for calling harmony imports with the correct context /******/ __webpack_require__.i = function(value) { return value; }; /******/ // define getter function for harmony exports /******/ __webpack_require__.d = function(exports, name, getter) { /******/ if(!__webpack_require__.o(exports, name)) { /******/ Object.defineProperty(exports, name, { /******/ configurable: false, /******/ enumerable: true, /******/ get: getter /******/ }); /******/ } /******/ }; /******/ // getDefaultExport function for compatibility with non-harmony modules /******/ __webpack_require__.n = function(module) { /******/ var getter = module && module.__esModule ? /******/ function getDefault() { return module['default']; } : /******/ function getModuleExports() { return module; }; /******/ __webpack_require__.d(getter, 'a', getter); /******/ return getter; /******/ }; /******/ // Object.prototype.hasOwnProperty.call /******/ __webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); }; /******/ // __webpack_public_path__ /******/ __webpack_require__.p = ""; /******/ // Load entry module and return exports /******/ return __webpack_require__(__webpack_require__.s = 1); /******/ }) /************************************************************************/ /******/ ([ /* 0 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; /* harmony default export */ __webpack_exports__["a"] = function () { var element = document.createElement('h1'); element.innerHTML = 'Hello world'; return element; }; /***/ }), /* 1 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; Object.defineProperty(__webpack_exports__, "__esModule", { value: true }); /* harmony import */ var __WEBPACK_IMPORTED_MODULE_0__component__ = __webpack_require__(0); document.body.appendChild(__webpack_require__.i(__WEBPACK_IMPORTED_MODULE_0__component__["a" /* default */])()); /***/ }) /******/ ]);
而app.js內容比較多了。整體是一個匿名函數。
(function(module) { })([(function (){}), function() {}])
app文件夾中的兩個js文件成了這兒的兩個模塊。函數最開始是從__webpack_require__開始
return __webpack_require__(__webpack_require__.s = 1);
這里指定從模塊1執行(賦值語句的返回值為其值)。而模塊1的調用是通過__webpack_require__的這句執行的。
modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
通過call調用模塊的主要作用是為了把參數傳過去。
(function(module, __webpack_exports__, __webpack_require__) { "use strict"; Object.defineProperty(__webpack_exports__, "__esModule", { value: true }); /* harmony import */ var __WEBPACK_IMPORTED_MODULE_0__component__ = __webpack_require__(0); document.body.appendChild(__webpack_require__.i(__WEBPACK_IMPORTED_MODULE_0__component__["a" /* default */])()); /***/ })
__webpack_require__ 每加載一個模塊都會先去模塊緩存中找,沒有就新建一個module對象:
var module = installedModules[moduleId] = { i: moduleId, l: false, exports: {} };
模塊1中加載了模塊0,
var __WEBPACK_IMPORTED_MODULE_0__component__ = __webpack_require__(0);
__WEBPACK_IMPORTED_MODULE_0__component__ 返回的是這個模塊0的exports部分。而之前Component.js的默認方法定義成了
__webpack_exports__["a"] = function () { var element = document.createElement('h1'); element.innerHTML = 'Hello world'; return element; }
所以再模塊1的定義通過"a“來獲取這個方法:
document.body.appendChild(__webpack_require__.i(__WEBPACK_IMPORTED_MODULE_0__component__["a" /* default */])());
這樣就完整了,但這里使用了__webpack_require__.i 將原值返回。
/******/ // identity function for calling harmony imports with the correct context /******/ __webpack_require__.i = function(value) { return value; };
不太明白這個i函數有什么作用。這個注釋也不太明白,路過的大神希望可以指點下。
小結:
webpack通過一個立即執行的匿名函數將各個開發模塊作為參數初始化,每個js文件(module)對應一個編號,每個js中export的方法或者對象有各自指定的關鍵字。通過這種方式將所有的模塊和接口方法管理起來。然后先加載最后的一個模塊(應該是引用別的模塊的模塊),這樣進而去觸發別的模塊的加載,使整個js運行起來。到這基本了解了webpack的功能和部分原理,但略顯復雜,且沒有感受到有多大的好處。繼續探索。
demo:http://files.cnblogs.com/files/stoneniqiu/webpack-ch1.zip 建議用最新的node安裝,不然build后的結果可能出錯。
參考:
https://survivejs.com/webpack/developing/getting-started/
【webpack】-- 模塊熱替換
2017-03-09 11:31 by stoneniqiu, 176 閱讀, 0 評論, 收藏, 編輯
全稱是Hot Module ReplaceMent(HMR),理解成熱模塊替換或者模塊熱替換都可以吧,和.net中的熱插拔一個意思,就是在運行中對程序的模塊進行更新。這個功能主要是用於開發過程中,對生產環境沒有任何幫助(這一點區別.net熱插拔)。效果上就是界面的無刷新更新。
HMR基於WDS,style-loader可以通過它來實現無刷新更新樣式。但是對於JavaScript模塊就需要做一點額外的處理,怎么處理繼續往下看。因為HMR是用於開發環境的,所以我們修改下配置,做兩份准備。一個用於生產,一個用於開發。
const path = require('path'); const HtmlWebpackPlugin = require('html-webpack-plugin'); const webpack = require('webpack'); const PATHS = { app: path.join(__dirname, 'app'), build: path.join(__dirname, 'build'), }; const commonConfig={ entry: { app: PATHS.app, }, output: { path: PATHS.build, filename: '[name].js', }, plugins: [ new HtmlWebpackPlugin({ title: 'Webpack demo', }), ], } function developmentConfig(){ const config ={ devServer:{ //使能歷史記錄api historyApiFallback:true, hotOnly:true,//關閉熱替換 注釋掉這行就行 stats:'errors-only', host:process.env.Host, port:process.env.PORT, overlay:{ errors:true, warnings:true, } }, plugins: [ new webpack.HotModuleReplacementPlugin(), ], }; return Object.assign( {}, commonConfig, config, { plugins: commonConfig.plugins.concat(config.plugins), } ); } module.exports = function(env){ console.log("env",env); if(env=='development'){ return developmentConfig(); } return commonConfig; };



plugins: [ new webpack.HotModuleReplacementPlugin(), new webpack.NamedModulesPlugin(), ],
import component from './component'; let demoComponent=component(); document.body.appendChild(demoComponent); //HMR 接口 if(module.hot){ module.hot.accept('./component',()=>{ const nextComponent=component(); document.body.replaceChild(nextComponent,demoComponent); demoComponent=nextComponent; }) }
並修改component.js:
export default function () { var element = document.createElement('h1'); element.innerHTML = 'Hello webpack'; return element; }
這個時候頁面更新了。每次改動頁面上都會增加一個帶有hot-update.js ,類似於下面這樣:
webpackHotUpdate(0,{ /***/ "./app/component.js": /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; Object.defineProperty(__webpack_exports__, "__esModule", { value: true }); /* harmony default export */ __webpack_exports__["default"] = function () { var element = document.createElement('h1'); element.innerHTML = 'Hello web '; element.className='box'; return element; }; /***/ }) })
通過webpackHotUpdate對相應模塊進行更新。0表示模塊的id,"./app/component.js"表示模塊對應的name。結構是webpack(id,{key:function(){}})。function外帶了一個括號,不知道有什么作用。webpackHotUpdate的定義是這樣的:
this["webpackHotUpdate"] = function webpackHotUpdateCallback(chunkId, moreModules) { // eslint-disable-line no-unused-vars
hotAddUpdateChunk(chunkId, moreModules); if(parentHotUpdateCallback) parentHotUpdateCallback(chunkId, moreModules); } ;
小結:從結構來看,一個是id,一個是對應修改的模塊。但實際執行更新的是hotApply方法。熱更新整個機制還是有點復雜,效果上像MVVM的那種綁定。有興趣的可以深入研究下。不建議在生產使用HMR,會讓整體文件變大,而且對生成沒有什么幫助,在下一節會講樣式的加載,style-loader就是用到了HMR。但對於js模塊還要寫額外的代碼,這讓人有點不爽。
demo:http://files.cnblogs.com/files/stoneniqiu/webpack-ch3.zip
參考:
【webpack】-- 自動刷新與解析
2017-02-26 23:53 by stoneniqiu, 298 閱讀, 0 評論, 收藏, 編輯
前端需要頻繁的修改js和樣式,且需要根據瀏覽器的頁面效果不斷的做調整;而且往往我們的開發目錄和本地發布目錄不是同一個,修改之后需要發布一下;另外一點就是並不是所有的效果都可以直接雙擊頁面就能看到,我們常常需要在本地用nginx建一個站點來觀察(自己電腦上ok了才放到測試環境去)。所以如果要用手工刷新瀏覽器和手動(或點擊)發布,還要啟動站點,確實是個不小的體力活。而這三點webpack可以幫我們做到。
webpack-dev-server
1.安裝
npm install webpack-dev-server --save-dev
先通過npm將其安裝到開發目錄。安裝完成之后會在node_modules/bin下找到。
2.npm啟動
然后修改package.json:(基於上一節)
"scripts": { "start": "webpack-dev-server --env development", "build": "webpack --env production" }
現在就可以通過npm run start 或者 npm start來啟動了。
啟動之后,可以看到Project is running at http://localhost:8080 上面。打開頁面
說明WDS已經幫我們自動建了一個站點.我們修改component.js ,cmd中會出現編譯,頁面會自動刷新。
3.直接啟動
官網介紹可以直接通過下面的命令啟動WDS。
webpack-dev-server --env development
但會出現webpack-dev-server --env development 不是內部命令的提示,這種問題都是環境變量的問題,將你開發的bin目錄設置到環境變量中即可,比如我的目錄是‘E:\Html5\node_modules\.bin’,就加上分號寫在后面。
C:\Users\Administrator.9BBOFZPACSCXLG2\AppData\Roaming\npm;C:\Program Files (x86)\Microsoft VS Code\bin;E:\Html5\node_modules\.bin
4.8080端口占用
如果默認的8080端口占用,WDS會換一個。比如用nginx先發布一個。
server{ listen 8080; location / { root E:/Html5/build; index index.html index.htm; } }
再啟動WDS:
端口切到了8081。也可以手動配置端口:
devServer:{ //... port: 9000 }
nodemon 自動啟動
WDS是監視開發文件的,webpack.config.js改變不會引起自動啟動。所以我們需要nodemon去做這件事情。
npm install nodemon --save-dev
先安裝在開發目錄,然后修改package.json:
"scripts": { "start": "nodemon --watch webpack.config.js --exec \"webpack-dev-server --env development\"", "build": "webpack --env production" },
等於讓nodemon去監視webpack.config.js,變化了就去啟動它。
這樣就你可以讓你的雙手專心的開發了。
代理
不過有一點疑問,就是WDS這個站點的替代性,因為我們自己部署的nginx有一些api的代理。如果掛在WDS的這個默認站點上自然是無法訪問的。換句話說可否給WDS配置一個刷新路徑。如果文件改變去刷新指定的地址,或者讓我去配個代理。既然它本身是一個http服務器,肯定也有代理的功能。搜了下果然有:https://github.com/webpack/webpack-dev-server/tree/master/examples/proxy-advanced
module.exports = { context: __dirname, entry: "./app.js", devServer: { proxy: { "/api": { target: "http://jsonplaceholder.typicode.com/", changeOrigin: true, pathRewrite: { "^/api": "" }, bypass: function(req) { if(req.url === "/api/nope") { return "/bypass.html"; } } } } } }
即將api這個字段替換成http://jsonplaceholder.typicode.com/,並將其從原地址中刪掉,這樣就可以自己實現代理了。皆大歡喜!WDS是通過 http-proxy-middleware 來實現代理。更多參考:http://webpack.github.io/docs/webpack-dev-server.html#bypass-the-proxy;https://github.com/chimurai/http-proxy-middleware#options
but,這種刷新是怎么實現的呢?因為頁面上沒有嵌入什么別的js,去翻原碼 web-dev-server/server.js中有這么一段:
Server.prototype._watch = function(path) { const watcher = chokidar.watch(path).on("change", function() { this.sockWrite(this.sockets, "content-changed"); }.bind(this)) this.contentBaseWatchers.push(watcher); }
用chokidar來監視文件變化,server的內部維護的有一個socket集合:
Server.prototype.sockWrite = function(sockets, type, data) { sockets.forEach(function(sock) { sock.write(JSON.stringify({ type: type, data: data })); }); }
sock是一個sockjs對象。https://github.com/sockjs/sockjs-client,從http://localhost:8080/webpack-dev-server/頁面來看,sockjs是用來通信記錄日志的。
var onSocketMsg = { hot: function() { hot = true; log("info", "[WDS] Hot Module Replacement enabled."); }, invalid: function() { log("info", "[WDS] App updated. Recompiling..."); sendMsg("Invalid"); }, hash: function(hash) { currentHash = hash; }, ... }
我們在看app.js,其中有一個OnSocketMsg 對象。

ok的時候觸發一個reloadApp
function reloadApp() { if(hot) { log("info", "[WDS] App hot update..."); var hotEmitter = __webpack_require__("./node_modules/webpack/hot/emitter.js"); hotEmitter.emit("webpackHotUpdate", currentHash); if(typeof self !== "undefined") { // broadcast update to window self.postMessage("webpackHotUpdate" + currentHash, "*"); } } else { log("info", "[WDS] App updated. Reloading..."); self.location.reload(); } }
也就是說WDS先檢測文件是否變化,然后通過sockjs通知到客戶端,這樣就實現了刷新。之前WebSocket的第三方只用過socket.io,看起來sockjs也蠻好用的。不必外帶一個js,在主js里面就可以寫了。
小結:效率提高的一方面是將一些機械的重復性流程或動作自動化起來。WDS和nodemon就是兩個為你干活的小弟。
【webpack】-- 樣式加載
2017-03-12 09:08 by stoneniqiu, 11 閱讀, 0 評論, 收藏, 編輯
一,樣式打包
1.安裝css-loader,style-loader
npm install css-loader style-loader --save-dev
2.修改webpack.config.js
module:{ rules:[{ test:/\.css$/, use: ['style-loader', 'css-loader'], }] },
3.添加樣式
body { background: cornsilk; }
然后在index.js中引入
import './main.css';
再運行npm start,在http://localhost:8080/中打開
這時候頁面出現了背景色,而且發現樣式寫入了header中,這個時候你改變顏色,界面也會無刷新的更新,這正是上一節HMR的效果。
樣式也是通過webpackHotUpdate方法進行更新。
二、加載less
再看一下如何加載less,先安裝less-loader
npm install less less-loader --save-dev
再修改配置文件:
module:{ rules:[{ test: /\.less$/, use: ['style-loader', 'css-loader', 'less-loader'], }] },
然后建立一個less文件。less.less
@base: #f938ab; .box-shadow(@style, @c) when (iscolor(@c)) { -webkit-box-shadow: @style @c; box-shadow: @style @c; } .box-shadow(@style, @alpha: 50%) when (isnumber(@alpha)) { .box-shadow(@style, rgba(0, 0, 0, @alpha)); } .box { color: saturate(@base, 5%); border-color: lighten(@base, 30%); div { .box-shadow(0 0 5px, 30%) } } body { background: cornsilk; }
修改index.js
import './less.less'; import component from './component'; var ele=document.createElement("div"); ele.innerHTML="this is an box"; ele.className="box"; document.body.appendChild(ele); let demoComponent=component(); document.body.appendChild(demoComponent);
得到效果:
可以看見編譯成功,要注意的是,再使用less的時候import只能是less文件,這個時候再import main.css會報錯。這一節對less就做一個簡單的演示,其他樣式預處理器同理,下面的內容還是繼續基於css。
三、理解css作用域和css 模塊
一般來說css的作用域都是全局的,我們常在母版頁里面添加了多個樣式文件,后面的樣式文件會覆蓋前面的樣式文件,常常給我們的調試帶來麻煩。而CSS Modules通過import引入了本地作用域。這樣能夠避免命名空間沖突。webpack的css-loader是支持CSS Modules的,怎么理解呢,先看幾個例子。我們先在配置中開啟(先關掉HMR):
module:{ rules:[{ test:/\.css$/, use: ['style-loader', { loader: 'css-loader', options: { modules: true,//讓css-loader支持Css Modules。 }, },],
然后定義一個新的樣式(main.css):
body { background: cornsilk; } .redButton { background: red;color:yellow; }
給component加一個樣式,先引入main.css。
import styles from './main.css'; export default function () { var element = document.createElement('h1'); element.className=styles.redButton; element.innerHTML = 'Hello webpack'; return element; }
這個時候我們看到界面已經變化了。
再看右邊生成的樣式,我們的樣式名稱已經發生了改變。回顧整個過程相當於main.css中的每一個類名成了一個模塊,在js中可以像獲取模塊一樣的獲取。但是你可能想,為毛我不能直接給元素賦值,干嘛要import呢。這是個好問題,我們再新增一個樣式
不同樣式文件的同名類
other.css
.redButton { background:rebeccapurple;color:snow; }
它也有一個.redbutton的類(但效果是紫色的),然后在index.js中創建一個div元素並給它添加redbutton樣式。
import './main.css'; import styles from './other.css'; import component from './component'; var ele=document.createElement("div"); ele.innerHTML="this is an other button"; ele.className=styles.redButton; document.body.appendChild(ele); let demoComponent=component(); document.body.appendChild(demoComponent);
再看效果
上面這個圖說明了兩問題,一個是我們在index.js中引入了2個樣式文件,在index頁面就輸出了兩個style,這讓人有點不爽,但我們后面再解決。另外一個就是雖然兩個樣式文件中都有redButton這個類,但是這兩者還是保持獨立的。這樣就避免了命名空間的相互干擾。如果你這個時候直接賦值
element.className="redButton";
這樣是獲取不到樣式的。直接對元素的樣式默認是全局的。
全局樣式
如果想讓某個樣式是全局的。可以通過:global來包住。
other.css
:global(.redButton) { background:rebeccapurple;color:snow; border: 1px solid red; }
main.css
:global(.redButton) { background: red;color:yellow; }
這個時候redbutton這兩個樣式就會合並。需要直接通過樣式名來獲取。
element.className="redButton";
組合樣式
我們再修改other.css,創建一個shadowButton 樣式,內部通過composes組合redbutton類。
.redButton { background:rebeccapurple;color:snow; border: 1px solid red; } .shadowButton{ composes:redButton; box-shadow: 0 0 15px black; }
修改index.js:
var ele=document.createElement("div"); ele.innerHTML="this is an shadowButton button"; console.log(styles); ele.className=styles.shadowButton; document.body.appendChild(ele);
看一下是什么效果:
日志打印出來的是styles對象,它包含了兩個類名。可以看見shadowButton是由兩個類名組合而成的。div的class和下面的對應。
四、輸出樣式文件
npm install extract-text-webpack-plugin --save-dev
先安裝extracttextplugin這個插件,然后再webpack.config.js中進行配置:
const ExtractTextPlugin = require('extract-text-webpack-plugin'); const extractTxtplugin = new ExtractTextPlugin({ filename: '[name].[contenthash:8].css', }); const commonConfig={ entry: { app: PATHS.app, }, output: { path: PATHS.build, filename: '[name].js', }, module:{ rules:[{ test:/\.css$/, use:extractTxtplugin.extract({ use:'css-loader', fallback: 'style-loader', }) }]}, plugins: [ new HtmlWebpackPlugin({ title: 'Webpack demo', }), extractTxtplugin ], }
一開始看到這個配置,讓人有點懵。首先看fileName,表示最后輸出的文件按照這個格式'[name].[contenthash:8].css',name默認是對應的文件夾名稱(這里是app),contenthash會返回特定內容的hash值,而:8表示取前8位。當然你也可以按照其他的格式寫,比如直接命名:
new ExtractTextPlugin('style.css')
而ExtractTextPlugin.extract本身是一個loader。fallback:'style-loader'的意思但有css沒有被提取(外部的css)的時候就用style-loader來處理。注意到現在我們的index.js如下:

import './main.css'; import styles from './other.css'; import component from './component'; var ele=document.createElement("div"); ele.innerHTML="this is an box"; ele.className=styles.shadowButton; document.body.appendChild(ele); let demoComponent=component(); document.body.appendChild(demoComponent); //HMR 接口 if(module.hot){ module.hot.accept('./component',()=>{ const nextComponent=component(); document.body.replaceChild(nextComponent,demoComponent); demoComponent=nextComponent; }) }
引入了兩個css文件。
這個時候我們執行 npm run build
再看文件夾得到一個樣式文件。(如果不想看到日志可以直接npm build)
但是我們在第三部分使用了CSS Modules,發現other.css的樣式沒有打包進來。所以,我們的webpack.config.js還要修改:
module:{ rules:[{ test:/\.css$/, use:extractTxtplugin.extract({ use:[ { loader: 'css-loader', options: { modules: true, }, }], fallback: 'style-loader', }) }]},
再次build。
發現兩個樣式打包成了一個文件。只要內容發生了變化,樣式的名稱就會變化。更多配置可以移步https://www.npmjs.com/package/extract-text-webpack-plugin
參考:
https://www.npmjs.com/package/css-loader#local-scope
https://survivejs.com/webpack/styling/loading/