webpack基礎+webpack配置文件常用配置項介紹+webpack-dev-server
一.webpack基礎
1.在項目中生成package.json:在項目根目錄中輸入npm init,根據提示輸入相應信息。(也可以不生成package.json文件,但是package.json是很有用的,所有建議生成)
2.安裝webpaack
a.在全局中安裝webpack:npm install webpack -g
b.將webpack安裝到項目並將webpack寫入package.json的devDependencies中:進入項目根目錄,然後在命令行中輸入npm install webpack --save-dev。
3.打包模塊
webpack <entry> <output>。<entry>用於指定打包的文件,<output>用於指定打包後的文件。如webpack app/index.js build/build.js表示將app文件夾中的index.js打包到build文件夾中的build.js中。
二.webpack配置文件常用配置項介紹
1.webpack有一個默認的配置文件webpack.config.js,這個文件需要手動的創建,位於項目根目錄中。可以為一個項目設置多個配置文件,已達到不同的配置文件完成不同的功能。怎麽設置後面介紹。
2.webpack的配置文件會暴露出一個對象,格式如下:
module.exports = {
//配置項
}
3.常用配置項將要說明
entry:打包的入口文件,一個字符串或者一個對象
output:配置打包的結果,一個對象
fileName:定義輸出文件名,一個字符串
path:定義輸出文件路徑,一個字符串
module:定義對模塊的處理邏輯,一個對象
loaders:定義一系列的加載器,一個數組
[
{
test:正則表達式,用於匹配到的文件
loader/loaders:字符串或者數組,處理匹配到的文件。如果只需要用到一個模塊加載器則使用 loader:string,如果要使用多個模塊加載器,則使用loaders:array
include:字符串或者數組,指包含的文件夾
exclude:字符串或者數組,指排除的文件夾
}
]
resolve:影響對模塊的解析,一個對象
extensions:自動補全識別後綴,是一個數組
plugins:定義插件,一個數組
4.entry詳細說明
(1)當entry是一個字符串時,這個字符串表示需要打包的模塊的路徑,如果只有一個要打包的模塊,可以使用這種
形式
(2)當entry是一個對象
a.是數組時,當需要將多個模塊打包成一個模塊,可以使用這個方式。如果這些模塊之間不存在依賴,數組中
值的順序沒有要求,如果存在依賴,則要將依賴性最高的模塊放在最後面。
例如:entry:["./app/one.js",".app/two.js"]
b.是鍵值對形式的對象是,當需要分別打包成多個模塊時,可以使用這種方式,例如;
entry:{
module1:"./app/one.js",
module2:["./app/two.js","./app/three.js"]
}
註:當entry是一個鍵值對形式的對象時,包名就是鍵名,output的filename不能是一個固定的值,因為每個包的
名字不能一樣
5.output詳細說明
(1)output是一個對象
(2)output.filename:指定輸出文件名,一個字符串。當輸出一個文件,output.filename為一個確定的字符串
如:output:{
filename:"build.js"
}
當輸出多個文件,output.filename不能為一個確定的字符串。為了讓每個文件有一個唯一的名字,需要用到下面
的變量
[name] is replaced by the name of the chunk.對應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:指定輸出文件的路徑,相對路徑,一個字符串
(4)output中還有其他的一些值,不在這裏說明,可以在webpack的官方網站中獲得更多的詳細信息
6.module.loaders詳細說明
(1)module是一個對象,定義對模塊的處理邏輯
(2)module.loaders是一個數組,定義一系列加載器,這個數組中的每一項都是一個對象
(3)module.loaders:[
{
test:正則,用於匹配要處理的文件
loader/loaders: 字符串或者數組, 如果只需要用到一個模塊加載器 ,則使用loader:string,
如果要使用多個模塊加載器,則使用loaders:array
include:字符串或者數組,指包含的文件夾
exclude:字符串或者數組,指排除的文件夾
}
]
(4)module除了可以配置loaders以外還能配置其他的值,在webpack的官網中獲得更多的信息
7.resolve.extensions詳細說明
(1)resolve.extensions並不是必須配置的,當不配置時,會使用默認值
["", ".webpack.js", ".web.js", ".js"],當手動為resolve.extensions設置值,
它的默認值會被覆蓋
(2)如果你想要每個模塊都能夠按照它們自己擴展名正確的被解析,要在數組中添加一個空字符串。
(3)如果你想請求一個js文件但是在請求時不帶擴展(如:require(‘somecode‘)),那麽就需要
將‘.js‘添加到數組中。其他文件一樣
(4)resolve還有其他的配置項,在webpack的官網獲得更多信息
8.補充
(1)當設置了配置文件後,在命令行中輸入webpack就可按照默認配置文件中的配置項打包模塊了。
(2)設置多個webpack配置文件。webpack默認的配置文件是webpack.config.js,當在命令行中輸入webpack時默認找的是 webpack.config.js。通過在package.json的scripts中添加例如
"start-html":"webpack --config webpack.html.config.js"
在命令行中輸入npm run start-html查找的就是webpack.html.config.js,通過這種方式可以實現不同的
配置文件有不同的用處,這樣就不用反復修改同一個配置文件
9.下面是一個簡單的配置文件
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是一個輕量級的服務器,修改文件源碼後,自動刷新頁面將修改同步到頁面上
2.安裝webpack-dev-server:
全局安裝:npm install webpack-dev-server -g
在項目中安裝並將依賴寫在package.json文件中:npm install webpack-dev-server --save-dev
3.使用命令webpack-dev-server --hot --inline完成自動刷新
4.默認的端口號是8080,如果需要8080端口被占用,就需要改端口,webpack-dev-server --port 3000(將端口號改為3000)
5.安裝webpack-dev-server後就可以在命令行中輸入webpack-dev-server開啟服務,然後在瀏覽器地址欄中
輸入localhost:端口號,就可以在瀏覽器中打開項目根目錄的index.html文件,如果項目根目錄中沒有index.html
文件,就會在瀏覽器中列出項目根目錄中的所有的文件夾。
6.第五條只是啟動服務並不能自動刷新,要自動刷新需要用到webpack-dev-server --hot --inline
7.當使用webpack-dev-server --hot --inline命令時,在每次修改文件,是將文件打包
保存在內存中並沒有寫在磁盤裏(默認是根據webpack.config.js打包文件,通過--config xxxx.js修改),這種打包得到的文件
和項目根目錄中的index.html位於同一級(但是你看不到,因為
它在內存中並沒有在磁盤裏)。使用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.每一次都敲一長串命令太麻煩,在項目根目錄的package.json文件的scripts配置中添加配置,如
"build":"webpack-dev-server --hot --inline",然後在命令行中輸入 npm run build就能
代替輸入一長串命令(webpack-dev-server --hot --inline),運行webpack-dev-server --hot --inline默認是找 webpack.config.js,通過--config命令可以修改為另一個配置文件。例如:webpack-dev-server --hot --inline --config ‘webpack.es6.config.js‘
9.配置根目錄
(1)當在命令行中輸入webpack-dev-server --hot --inline,再在瀏覽器中輸入localhost:端口號,瀏覽器會在項目的
根目錄中去查找內容,通過--content-base可以配置根目錄。
如webpack-dev-server --hot --inline --content-base ‘./build/‘,在build文件夾中去加載index.html,如果沒有
index.html文件,將會在瀏覽器中顯示所有build目錄下的文件和文件夾
四.例子
我一個設置了兩個webpack的配置文件分別是webpack.config.js和webpack.react.config.js。package.json文件中scripts對象的內容如下:
"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"
}
webpack基礎+webpack配置文件常用配置項介紹+webpack-dev-server