DIV CSS 佈局教程網

Webpack 常用配置項與 webpack-dev-server 詳解
編輯:關於JavaScript     

把 Webpack 的配置项和 dev-server 的用法系統梳理一遍,方便日後查閱。

一、Webpack 基礎

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: 定義插件,數組

三、entry 詳解

(1)字符串形式:表示單個要打包的模塊路徑。

(2)對象形式:

值為數組時,可把多個模塊打進同一個包。若這些模塊之間沒有依賴,數組順序隨意;若存在依賴,要把依賴層級最深的放在最後。

entry: ["./app/one.js", "./app/two.js"]

值為鍵值對時,可分別打包成多個包:

entry: {
  module1: "./app/one.js",
  module2: ["./app/two.js", "./app/three.js"]
}

注意:此時包名就是鍵名,output.filename 不能寫死,否則多個包會重名。

四、output 詳解

(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 詳解

module: {
  loaders: [
    {
      test: /.*\.css$/,                  //正則,匹配要處理的文件
      loaders: ['style', 'css'],        //多個加載器用數組
      exclude: './node_modules/'        //排除的文件夾
    }
  ]
}

只用一個加載器時寫 loader: 'babel';要用多個時寫 loaders: ['style', 'css']。module 下除 loaders 之外還有其他配置,官網有更完整的說明。

六、resolve.extensions 詳解

(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']
  }
};

八、webpack-dev-server

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 命令,配置文件之間互不干擾。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved