把 Webpack 的配置项和 dev-server 的用法系統梳理一遍,方便日後查閱。
1. 生成 package.json:在項目根目錄執行 npm init,按提示填寫信息。不生成也能跑,但 package.json 很有用,建議還是創建。
2. 安裝 webpack
# 全局安裝 npm install webpack -g # 安裝到項目並寫入 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。
1. webpack 有一個默認配置文件 webpack.config.js,需要手動創建並放在項目根目錄。也可以為一個項目設置多個配置文件,讓不同配置承擔不同職責。
2. 配置文件本質上導出一個對象:
module.exports = {
//配置項
}
3. 主要配置項一覽
entry: 打包的入口文件,字符串或對象
output: 配置打包結果,對象
filename: 定義輸出文件名,字符串
path: 定義輸出路徑,字符串
module: 定義對模塊的處理邏輯,對象
loaders: 定義一系列加載器,數組
test: 正則表達式,用於匹配文件
loader / loaders: 字符串或數組。只用一個加載器時寫 loader: string,
多個時寫 loaders: array
include: 字符串或數組,指定包含的文件夾
exclude: 字符串或數組,指定排除的文件夾
resolve: 影響對模塊的解析,對象
extensions: 自動補全識別後綴,數組
plugins: 定義插件,數組
(1)字符串形式:表示單個要打包的模塊路徑。
(2)對象形式:
值為數組時,可把多個模塊打進同一個包。若這些模塊之間沒有依賴,數組順序隨意;若存在依賴,要把依賴層級最深的放在最後。
entry: ["./app/one.js", "./app/two.js"]
值為鍵值對時,可分別打包成多個包:
entry: {
module1: "./app/one.js",
module2: ["./app/two.js", "./app/three.js"]
}
注意:此時包名就是鍵名,output.filename 不能寫死,否則多個包會重名。
(1) output 是一個對象。
(2)output.filename:輸出文件名。只輸出一個文件時可以是確定的字符串:
output: { filename: "build.js" }
輸出多個文件時必須借助占位符保證唯一:
[name] 替換為 chunk 的名稱,對應 entry 的鍵名 [hash] 替換為本次 compilation 的 hash [chunkhash] 替換為該 chunk 的 hash
例如:
output: {
path: './build/',
filename: '[name].js'
}
(3)output.path:輸出路徑,字符串。
(4) output 還有其他可配置項,更多信息可查 webpack 官網。
module: {
loaders: [
{
test: /.*\.css$/, //正則,匹配要處理的文件
loaders: ['style', 'css'], //多個加載器用數組
exclude: './node_modules/' //排除的文件夾
}
]
}
只用一個加載器時寫 loader: 'babel';要用多個時寫 loaders: ['style', 'css']。module 下除 loaders 之外還有其他配置,官網有更完整的說明。
(1) 並非必填。不配置時使用默認值 ["", ".webpack.js", ".web.js", ".js"];一旦手動賦值,默認值會被完全覆蓋。
(2) 希望每個模塊都能按自身擴展名正確解析,數組裡要保留一個空字符串。
(3) 想在 require 時省略後綴(如 require('somecode')),就要把 '.js' 放進數組,其他類型同理。
(1) 配置好 webpack.config.js 後,命令行直接執行 webpack 就會按它打包。
(2)多配置文件:默認查找的是 webpack.config.js。可以在 package.json 的 scripts 裡加一條,例如:
"start-html": "webpack --config webpack.html.config.js"
然後執行 npm run start-html 就會讀取 webpack.html.config.js。這樣不同環境用不同配置,不必反覆改同一個文件。
(3)一個簡單的完整配置
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']
}
};
1. 它是一個輕量級服務器,源碼修改後能自動刷新頁面。
2. 安裝
npm install webpack-dev-server -g npm install webpack-dev-server --save-dev
3. 使用 webpack-dev-server --hot --inline 完成自動刷新。
4. 默認端口 8080,被佔用時可通過 --port 3000 修改。
5. 啟動後瀏覽器訪問 localhost:端口號,會打開項目根目錄下的 index.html;若沒有該文件,則會列出根目錄的所有文件與文件夾。
6. 注意:僅執行 webpack-dev-server 只啟動服務,不會自動刷新,必須加上 --hot --inline。
7. 加上 --hot --inline 後,每次改動文件都會打包在內存中而非寫入磁盤(默認讀 webpack.config.js,可用 --config 更換)。這些內存中的產物與根目錄的 index.html 位於同一級,只是你在磁盤上看不到。
所以引用路徑也不同:
<!-- 引入 dev-server 打包的產物 --> <script src="build.js"></script> <!-- 引入 webpack 命令打包的產物 --> <script src="./build/build.js"></script>
8. 每次敲長命令太麻煩,可以在 package.json 的 scripts 裡配:
"build": "webpack-dev-server --hot --inline"
然後用 npm run build 代替。需要換配置時加 --config:
webpack-dev-server --hot --inline --config 'webpack.es6.config.js'
9. 配置根目錄:dev-server 默認在項目根目錄查找內容,可用 --content-base 指定:
webpack-dev-server --hot --inline --content-base './build/'
這樣會去 build 文件夾加載 index.html;若該文件不存在,瀏覽器會列出 build 目錄下的所有內容。
我設置了兩個配置文件: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"
}
這樣一來,普通環境和 React 環境各自獨立,切換時只需換一條 npm 命令,配置文件之間互不干擾。