webpack基礎+webpack配置文件經常使用配置項介紹+webpack-dev-server

一.webpack基礎

  1.在項目中生成package.json:在項目根目錄中輸入npm init,根據提示輸入相應信息。(也能夠不生成package.json文件,可是package.json是頗有用的,全部建議生成)css

  2.安裝webpaackhtml

    a.在全局中安裝webpack:npm install webpack -gnode

    b.將webpack安裝到項目並將webpack寫入package.json的devDependencies中:進入項目根目錄,而後在命令行中輸入npm install webpack --save-dev。react

  3.打包模塊webpack

  webpack <entry> <output>。<entry>用於指定打包的文件,<output>用於指定打包後的文件。如webpack app/index.js       build/build.js表示將app文件夾中的index.js打包到build文件夾中的build.js中。git

二.webpack配置文件經常使用配置項介紹

  1.webpack有一個默認的配置文件webpack.config.js,這個文件須要手動的建立,位於項目根目錄中。能夠爲一個項目設置多個配置文件,已達到不一樣的配置文件完成不一樣的功能。怎麼設置後面介紹。es6

  2.webpack的配置文件會暴露出一個對象,格式以下:github

    module.exports = {
      //配置項
    }web

  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"
    }
相關文章
相關標籤/搜索