一官还、webpack基礎(chǔ)
1毯焕、生成package.json
在項(xiàng)目中生成package.json:在項(xiàng)目根目錄中輸入npm init矫废,根據(jù)提示輸入相應(yīng)信息赂蠢。(也可以不生成package.json文件绪穆,但是package.json是很有用的,所有建議生成)
2虱岂、安裝webpack
a.在全局中安裝webpack:npm install webpack -g?
b.將webpack安裝到項(xiàng)目并將webpack寫入package.json的devDependencies中:進(jìn)入項(xiàng)目根目錄玖院,然后在命令行中輸入npm install webpack --save-dev。
3第岖、打包模塊
<entry>用于指定打包的文件
<output>用于指定打包后的文件
build/build.js表示將app文件夾中的index.js打包到build文件夾中的build.js中难菌。
build/build.js表示將app文件夾中的index.js打包到build文件夾中的build.js中。
二蔑滓、webpack配置文件常用配置項(xiàng)介紹
1郊酒、webpack.config.js
webpack有一個(gè)默認(rèn)的配置文件webpack.config.js,這個(gè)文件需要手動(dòng)的創(chuàng)建键袱,位于項(xiàng)目根目錄中燎窘。可以為一個(gè)項(xiàng)目設(shè)置多個(gè)配置文件蹄咖,已達(dá)到不同的配置文件完成不同的功能褐健。怎么設(shè)置后面介紹。
2澜汤、webpack的配置
文件會(huì)暴露出一個(gè)對(duì)象蚜迅,格式如下:
module.exports = {
//配置項(xiàng)
}
3、常用配置項(xiàng)將要說明
entry:打包的入口文件银亲,一個(gè)字符串或者一個(gè)對(duì)象
output:配置打包的結(jié)果慢叨,一個(gè)對(duì)象
fileName:定義輸出文件名,一個(gè)字符串
path:定義輸出文件路徑务蝠,一個(gè)字符串
module:定義對(duì)模塊的處理邏輯拍谐,一個(gè)對(duì)象
loaders:定義一系列的加載器,一個(gè)數(shù)組
[
? ? {
? ? ? ? test:正則表達(dá)式,用于匹配到的文件
? ? ? ? loader/loaders:字符串或者數(shù)組轩拨,處理匹配到的文件践瓷。如果只需要用到一個(gè)模塊加載器則使用loader:string,如果要使用多個(gè)模塊加載器亡蓉,則使用loaders:array
? ? ? ? include:字符串或者數(shù)組晕翠,指包含的文件夾
? ? ? ? exclude:字符串或者數(shù)組,指排除的文件夾
? ? }
]
resolve:影響對(duì)模塊的解析砍濒,一個(gè)對(duì)象
extensions:自動(dòng)補(bǔ)全識(shí)別后綴淋肾,是一個(gè)數(shù)組
plugins:定義插件,一個(gè)數(shù)組
4爸邢、entry詳細(xì)說明
(1)當(dāng)entry是一個(gè)字符串時(shí)樊卓,這個(gè)字符串表示需要打包的模塊的路徑,如果只有一個(gè)要打包的模塊,可以使用這種形式
(2)當(dāng)entry是一個(gè)對(duì)象
a.是數(shù)組時(shí),當(dāng)需要將多個(gè)模塊打包成一個(gè)模塊杠河,可以使用這個(gè)方式碌尔。如果這些模塊之間不存在依賴,數(shù)組中值的順序沒有要求券敌,如果存在依賴唾戚,則要將依賴性最高的模塊放在最后面。
例如:entry:["./app/one.js",".app/two.js"]
b.是鍵值對(duì)形式的對(duì)象是待诅,當(dāng)需要分別打包成多個(gè)模塊時(shí)叹坦,可以使用這種方式,例如咱士;
entry:{
? ? module1:"./app/one.js",
? ? module2:["./app/two.js","./app/three.js"]
}
注:當(dāng)entry是一個(gè)鍵值對(duì)形式的對(duì)象時(shí)立由,包名就是鍵名轧钓,output的filename不能是一個(gè)固定的值序厉,因?yàn)槊總€(gè)包的名字不能一樣
5、output詳細(xì)說明
(1)output是一個(gè)對(duì)象
(2)output.filename:指定輸出文件名毕箍,一個(gè)字符串弛房。當(dāng)輸出一個(gè)文件,output.filename為一個(gè)確定的字符串
如:
output:{
? ? filename:"build.js"
}
當(dāng)輸出多個(gè)文件而柑,output.filename不能為一個(gè)確定的字符串文捶。為了讓每個(gè)文件有一個(gè)唯一的名字,需要用到下面的變量
[name] is replaced by the name of the chunk.對(duì)應(yīng)entry的鍵名
[hash] is replaced by the hash of the compilation.
[chunkhash] is replaced by the hash of the chunk.
如:
output:{
? ? path:'./build/',
? ? fialname:'[name].js'
}
(3)output.path:指定輸出文件的路徑媒咳,相對(duì)路徑粹排,一個(gè)字符串
(4)output中還有其他的一些值,不在這里說明,可以在webpack的官方網(wǎng)站中獲得更多的詳細(xì)信息
6涩澡、module.loaders詳細(xì)說明
(1)module是一個(gè)對(duì)象顽耳,定義對(duì)模塊的處理邏輯
(2)module.loaders是一個(gè)數(shù)組,定義一系列加載器,這個(gè)數(shù)組中的每一項(xiàng)都是一個(gè)對(duì)象
(3)
module.loaders:[
? ? {
? ? ? ? test:正則射富,用于匹配要處理的文件
? ? ? ? loader/loaders: 字符串或者數(shù)組膝迎, 如果只需要用到一個(gè)模塊加載器 ,則使用loader:string,如果要使用多個(gè)模塊加載器胰耗,則使用loaders:array
? ? ? ? include:字符串或者數(shù)組限次,指包含的文件夾
? ? ? ? exclude:字符串或者數(shù)組,指排除的文件夾
? ? }
]
(4)module除了可以配置loaders以外還能配置其他的值,在webpack的官網(wǎng)中獲得更多的信息
7柴灯、resolve.extensions詳細(xì)說明
(1)resolve.extensions并不是必須配置的卖漫,當(dāng)不配置時(shí),會(huì)使用默認(rèn)值
["", ".webpack.js", ".web.js", ".js"]
赠群,當(dāng)手動(dòng)為resolve.extensions設(shè)置值懊亡,它的默認(rèn)值會(huì)被覆蓋
(2)如果你想要每個(gè)模塊都能夠按照它們自己擴(kuò)展名正確的被解析,要在數(shù)組中添加一個(gè)空字符串乎串。
(3)如果你想請(qǐng)求一個(gè)js文件但是在請(qǐng)求時(shí)不帶擴(kuò)展(如:
require('somecode'))
,那么就需要將'.js'添加到數(shù)組中店枣。其他文件一樣
(4)resolve還有其他的配置項(xiàng),在webpack的官網(wǎng)獲得更多信息
8叹誉、補(bǔ)充
(1)當(dāng)設(shè)置了配置文件后鸯两,在命令行中輸入webpack就可按照默認(rèn)配置文件中的配置項(xiàng)打包模塊了。
(2)設(shè)置多個(gè)webpack配置文件长豁。webpack默認(rèn)的配置文件是webpack.config.js,當(dāng)在命令行中輸入webpack時(shí)默認(rèn)找的是webpack.config.js钧唐。通過在package.json的scripts中添加例如
"start-html":"webpack --config webpack.html.config.js"
在命令行中輸入npm run start-html查找的就是webpack.html.config.js,通過這種方式可以實(shí)現(xiàn)不同的配置文件有不同的用處匠襟,這樣就不用反復(fù)修改同一個(gè)配置文件
9钝侠、下面是一個(gè)簡單的配置文件
module.exports = {
? ? entry:{
? ? ? ? one:"./app/one.js",
? ? ? ? two:"./app/two.js"
? ? },
? ? output:{
? ? ? ? path:"./build/",
? ? ? ? filename:"[name].js"
? ?},
? ? module:{
? ? ? ? loaders:[
? ? ? ? {
? ? ? ? ? ? test:/.*\.css$/,
? ? ? ? ? ? loaders:["style","css"],
? ? ? ? ? ? exclude:'./node_modules/'
? ? ? ? }
? ? ? ? ]
? ? },
? ? resolve:{
? ? ? ? extensions:['','.css','.js','jsx']
? ? }
};
三、webpack-dev-server
1.webpack-dev-server是一個(gè)輕量級(jí)的服務(wù)器酸舍,修改文件源碼后帅韧,自動(dòng)刷新頁面將修改同步到頁面上
2.安裝webpack-dev-server:
全局安裝:npm install webpack-dev-server -g
在項(xiàng)目中安裝并將依賴寫在package.json文件中:npm install webpack-dev-server --save-dev
3.使用命令webpack-dev-server --hot --inline完成自動(dòng)刷新
4.默認(rèn)的端口號(hào)是8080,如果需要8080端口被占用啃勉,就需要改端口忽舟,webpack-dev-server --port 3000(將端口號(hào)改為3000)
5.安裝webpack-dev-server后就可以在命令行中輸入webpack-dev-server開啟服務(wù),然后在瀏覽器地址欄中輸入localhost:端口號(hào)淮阐,就可以在瀏覽器中打開項(xiàng)目根目錄的index.html文件叮阅,如果項(xiàng)目根目錄中沒有index.html文件,就會(huì)在瀏覽器中列出項(xiàng)目根目錄中的所有的文件夾泣特。
6.第五條只是啟動(dòng)服務(wù)并不能自動(dòng)刷新浩姥,要自動(dòng)刷新需要用到webpack-dev-server --hot --inline
7.當(dāng)使用webpack-dev-server --hot --inline命令時(shí),在每次修改文件状您,是將文件打包保存在內(nèi)存中并沒有寫在磁盤里(默認(rèn)是根據(jù)webpack.config.js打包文件勒叠,通過--config xxxx.js修改)镀裤,這種打包得到的文件和項(xiàng)目根目錄中的index.html位于同一級(jí)(但是你看不到,因?yàn)樗趦?nèi)存中并沒有在磁盤里)缴饭。使用webpack命令將打包后的文件保存在磁盤中
例如在index.html文件中引入通過webpack-dev-server --hot --inline打包的build.js
<script src="build.js"></script>
在index.html文件中引入通過webpack命令打包的build.js
<script src="./build/build.js"></script>
8.每一次都敲一長串命令太麻煩暑劝,在項(xiàng)目根目錄的package.json文件的scripts配置中添加配置,如
"build":"webpack-dev-server --hot --inline"
,然后在命令行中輸入 npm run build就能代替輸入一長串命令(webpack-dev-server --hot --inline)颗搂,運(yùn)行
webpack-dev-server --hot --inline
默認(rèn)是找webpack.config.js,通過--config命令可以修改為另一個(gè)配置文件担猛。例如:
webpack-dev-server --hot --inline --config 'webpack.es6.config.js'
9、配置根目錄
(1)當(dāng)在命令行中輸入
webpack-dev-server --hot --inline
丢氢,再在瀏覽器中輸入localhost:端口號(hào)傅联,瀏覽器會(huì)在項(xiàng)目的根目錄中去查找內(nèi)容,通過--content-base可以配置根目錄疚察。如
webpack-dev-server --hot --inline --content-base './build/'
蒸走,在build文件夾中去加載index.html,如果沒有index.html文件貌嫡,將會(huì)在瀏覽器中顯示所有build目錄下的文件和文件夾
四比驻、例子
我一個(gè)設(shè)置了兩個(gè)webpack的配置文件分別是webpack.config.js和webpack.react.config.js。package.json文件中scripts對(duì)象的內(nèi)容如下:
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"react": "webpack --config webpack.react.config.js",
"build": "webpack-dev-server --hot --inline --content-base ./build/",
"build-react": "webpack-dev-server --hot --inline --content-base ./react-build/ --config webpack.react.config.js"
}