webpack4 多入口,多頁面項目構(gòu)建案例

歡迎關(guān)注小程序“進階的大前端”拓瞪,800多道前端面試題在線查看

image

2019年 03-24日更新

更新如下

更新后報錯

clean-webpack-plugin only accepts an options object

原因是clean-webpack-plugin插件更新版本后,new cleanWebpackPlugin(),里只能傳一個對象參數(shù)了卡儒,配置地址https://github.com/johnagan/clean-webpack-plugin#options-and-defaults-optional

以下是原文

趁工作之余從零構(gòu)建了一個webpack4.x多頁面應(yīng)用程序田柔。過程中也遇到一些坑,就記錄下來了骨望。


webpack核心概念

  • Entry:入口硬爆,Webpack 執(zhí)行構(gòu)建的第一步將從 Entry 開始。
  • Module:模塊擎鸠,在 Webpack 里一切皆模塊缀磕,一個模塊對應(yīng)著一個文件。Webpack 會從配置的 Entry 開始遞歸找出所有依賴的模塊。
  • Chunk:代碼塊虐骑,一個 Chunk 由多個模塊組合而成准验,用于代碼合并與分割。
  • Loader:模塊轉(zhuǎn)換器廷没,用于把模塊原內(nèi)容按照需求轉(zhuǎn)換成新內(nèi)容。
  • Plugin:擴展插件垂寥,在 Webpack 構(gòu)建流程中的特定時機注入擴展邏輯來改變構(gòu)建結(jié)果或做你想要的事情颠黎。
  • Output:輸出結(jié)果,在 Webpack 經(jīng)過一系列處理并得出最終想要的代碼后輸出結(jié)果滞项。
    項目的運行主要圍繞的就是這幾大塊

首先看一下構(gòu)建后目錄
├── build
│ ├── webpack.base.conf.js
│ ├── webpack.dev.conf.js
│ ├── webpack.prod.conf.js
│ ├── webpack.rules.conf.js
├── src
│ ├── css
│ ├── js
│ ├── images
│ ├── assets
│ ├── pages
│ │ ├── index
│ │ │ ├── index.html
│ │ │ ├── index.js
│ │ │ └── index.scss
│ │ ├── login
│ │ │ ├── index.html
│ │ │ ├── index.js
│ │ │ └── index.scss

1.多頁面的入口文件

修改 webpack.base.conf.js代碼
entry: {
        // 多入口文件
        index: ['./src/pages/index/index.js',],
        login: './src/pages/login/index.js',
    },

2.配置開發(fā)服務(wù)器

npm install webpack-dev-server --save-dev
//修改 webpack.dev.conf.js代碼

devServer: {
    contentBase: path.join(__dirname, "../dist"),
    publicPath:'/',
    host: "127.0.0.1",
    port: "8089",
    overlay: true, // 瀏覽器頁面上顯示錯誤
    // open: true, // 開啟自動打開瀏覽器
    // stats: "errors-only", //stats: "errors-only"表示只打印錯誤:
    hot: true // 開啟熱更新
},
//修改package.json
scripts: {
    "dev": "cross-env NODE_ENV=development webpack-dev-server  --config build/webpack.dev.conf.js",
    "build": "cross-env NODE_ENV=production webpack --config build/webpack.prod.conf.js",
    "server": "live-server ./ --port=8888"
},

3.配置loader

{
    test: /\.(css|scss|sass)$/,
    // 不分離的寫法
    // use: ["style-loader", "css-loader",sass-loader"]
    // 使用postcss不分離的寫法
    // use: ["style-loader", "css-loader", sass-loader","postcss-loader"]
    // 此處為分離css的寫法
    /*use: extractTextPlugin.extract({
        fallback: "style-loader",
        use: ["css-loader", "sass-loader"],
        // css中的基礎(chǔ)路徑
        publicPath: "../"
    })*/
    // 此處為使用postcss分離css的寫法
    use: extractTextPlugin.extract({
        fallback: "style-loader",
        use: ["css-loader", "sass-loader", "postcss-loader"],
        // css中的基礎(chǔ)路徑
        publicPath: "../"

    })
},
{
    test: /\.js$/,
    use: ["babel-loader"],
    // 不檢查node_modules下的js文件
    exclude: "/node_modules/"
}, {
    test: /\.(png|jpg|gif)$/,
    use: [{
        // 需要下載file-loader和url-loader
        loader: "url-loader",
        options: {
            limit: 5 * 1024,//小于這個時將會已base64位圖片打包處理
            // 圖片文件輸出的文件夾
            outputPath: "images"
        }
    }]
}

4.從js中分離css

npm install extract-text-webpack-plugin --save-dev 
//這個插件在webpack4.x 運行時會有點問題,后面會提到
//修改 webpack.base.conf.js代碼
// 分離css插件參數(shù)為提取出去的路徑
new extractTextPlugin({
    filename: 'css/[name].[hash:8].min.css',
}),

5.處理css3屬性前綴狭归,消除冗余的css代碼并壓縮css

//屬性自動加前綴
npm install postcss-loader --save-dev 
//在根目錄新建postcss.config.js
module.exports = {
    plugins: [
        require('autoprefixer')//自動添加css前綴
    ]
};
//loader里加入postcss
{
    test: /\.(css|scss|sass)$/,
    // 此處為使用postcss分離css的寫法
    use: extractTextPlugin.extract({
        fallback: "style-loader",
        use: ["css-loader", "sass-loader", "postcss-loader"],
        // css中的基礎(chǔ)路徑
        publicPath: "../"

    })
}
//修改package.json 加入css要兼容瀏覽器版本的代碼
"browserslist": [
    "defaults",
    "not ie < 11",
    "last 2 versions",
    "> 1%",
    "iOS 7",
    "last 3 iOS versions"
]
//消除冗余css代碼 使用glob模塊去匹配文件所以還要安裝glob模塊
npm install purifycss-webpack --save-dev 
new purifyCssWebpack({
    paths: glob.sync(path.join(__dirname, "../src/pages/*/*.html"))
}),
//壓縮css
npm install optimize-css-assets-webpack-plugin --save-dev 
//壓縮css
//修改 webpack.prod.conf.js代碼
new OptimizeCSSPlugin({
    cssProcessorOptions: {
        safe: true
    }
}),

5.清空打包目錄

npm install clean-webpack-plugin --save-dev 
//修改 webpack.prod.conf.js代碼
//刪除dist目錄
new cleanWebpackPlugin(['dist'], {
    root: path.resolve(__dirname, '../'), //根目錄
    // verbose Write logs to console.
    verbose: true, //開啟在控制臺輸出信息
    // dry Use boolean "true" to test/emulate delete. (will not remove files).
    // Default: false - remove files
    dry: false,
}),

6. 壓縮js

npm install uglifyjs-webpack-plugin --save-dev 
//修改 webpack.prod.conf.js代碼
//上線壓縮 去除console等信息webpack4.x之后去除了webpack.optimize.UglifyJsPlugin
//https://github.com/mishoo/UglifyJS2/tree/harmony#compress-options
new UglifyJSPlugin({
    uglifyOptions: {
        compress: {
            warnings: false,
            drop_debugger: false,
            drop_console: true
        }
    }
}),

7.提取js公共模塊

// webpack4里面移除了commonChunksPulgin插件,放在了config.optimization里面,提取js文判, vendor名字可改
optimization: {
    splitChunks: {
        cacheGroups: {
            vendor: {
                // test: /\.js$/,
                test: /[\\/]node_modules[\\/]/,
                chunks: "initial", //表示顯示塊的范圍过椎,有三個可選值:initial(初始塊)、async(按需加載塊)戏仓、all(全部塊)疚宇,默認為all;
                name: "vendor", //拆分出來塊的名字(Chunk Names),默認由塊名和hash值自動生成赏殃;
                enforce: true,
            }
        }
    }
},
//項目里配置了自動提取node_modules里用到的模塊如jquery敷待,也可以在原模板里面通過第三方cdn引入,又是另一種配置了仁热。在 webpack.base.conf.js利配置externals后webpack就不會去打包配置模塊
externals: {
    'jquery': 'window.jQuery'
},
//externals就是webpack可以不處理應(yīng)用的某些依賴庫榜揖,使用externals配置后,依舊可以在代碼中通過CMD抗蠢、AMD或者window/global全局的方式訪問举哟。

8.復(fù)制靜態(tài)資源

npm install copy-webpack-plugin --save-dev 
//靜態(tài)資源輸出,將src目錄下的assets文件夾復(fù)制到dist目錄下
new copyWebpackPlugin([{
    from: path.resolve(__dirname, "../src/assets"),
    to: './assets',
    ignore: ['.*']
}]),

9.產(chǎn)出html

npm install html-webpack-plugin --save-dev 
//修改webpack.base.conf.js代碼
// 獲取html-webpack-plugin參數(shù)的方法
var getHtmlConfig = function (name, chunks) {
    return {
        template: `./src/pages/${name}/index.html`,
        filename: `${name}.html`,
        // favicon: './favicon.ico',
        // title: title,
        inject: true,
        hash: true, //開啟hash  ?[hash]
        chunks: chunks,//頁面要引入的包
        minify: process.env.NODE_ENV === "development" ? false : {
            removeComments: true, //移除HTML中的注釋
            collapseWhitespace: true, //折疊空白區(qū)域 也就是壓縮代碼
            removeAttributeQuotes: true, //去除屬性引用
        },
    };
};
//配置頁面
const htmlArray = [{
        _html: 'index',
        title: '首頁',
        chunks: ['vendor', 'index']//頁面用到的vendor模塊
    },
    {
        _html: 'login',
        title: '登錄',
        chunks: ['login']
    },
];
//自動生成html模板
htmlArray.forEach((element) => {
    module.exports.plugins.push(new htmlWebpackPlugin(getHtmlConfig(element._html, element.chunks)));
})

10.性能優(yōu)化 高大上的可視化分析模塊

npm install webpack-bundle-analyzer --save-dev 
//修改 webpack.prod.conf.js代碼
new BundleAnalyzerPlugin()
//npm run build 后會打開一個頁面
cmd-markdown-logo

通過這個頁面可以看到哪些頁面是由哪些模塊組成的,通過這個可視化頁面可以更加方便去定位哪個包臃腫了迅矛,然后去優(yōu)化妨猩。

報錯 & 解決辦法

Error: Chunk.entrypoints: Use Chunks.groupsIterable and filter by instanceof Entrypoint instead
后來發(fā)現(xiàn)webpack4不支持extract-text-webpack-plugin 必須下載next版本安裝這個插件
npm install extract-text-webpack-plugin@next
https://github.com/webpack-contrib/extract-text-webpack-plugin/issues/701

項目源碼

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市诬乞,隨后出現(xiàn)的幾起案子册赛,更是在濱河造成了極大的恐慌,老刑警劉巖震嫉,帶你破解...
    沈念sama閱讀 217,826評論 6 506
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件森瘪,死亡現(xiàn)場離奇詭異,居然都是意外死亡票堵,警方通過查閱死者的電腦和手機扼睬,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,968評論 3 395
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人窗宇,你說我怎么就攤上這事措伐。” “怎么了军俊?”我有些...
    開封第一講書人閱讀 164,234評論 0 354
  • 文/不壞的土叔 我叫張陵侥加,是天一觀的道長。 經(jīng)常有香客問我粪躬,道長担败,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,562評論 1 293
  • 正文 為了忘掉前任镰官,我火速辦了婚禮提前,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘泳唠。我一直安慰自己狈网,他們只是感情好,可當我...
    茶點故事閱讀 67,611評論 6 392
  • 文/花漫 我一把揭開白布笨腥。 她就那樣靜靜地躺著拓哺,像睡著了一般。 火紅的嫁衣襯著肌膚如雪扇雕。 梳的紋絲不亂的頭發(fā)上拓售,一...
    開封第一講書人閱讀 51,482評論 1 302
  • 那天,我揣著相機與錄音镶奉,去河邊找鬼础淤。 笑死,一個胖子當著我的面吹牛哨苛,可吹牛的內(nèi)容都是我干的鸽凶。 我是一名探鬼主播,決...
    沈念sama閱讀 40,271評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼建峭,長吁一口氣:“原來是場噩夢啊……” “哼玻侥!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起亿蒸,我...
    開封第一講書人閱讀 39,166評論 0 276
  • 序言:老撾萬榮一對情侶失蹤凑兰,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后边锁,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體姑食,經(jīng)...
    沈念sama閱讀 45,608評論 1 314
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,814評論 3 336
  • 正文 我和宋清朗相戀三年茅坛,在試婚紗的時候發(fā)現(xiàn)自己被綠了音半。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,926評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖曹鸠,靈堂內(nèi)的尸體忽然破棺而出煌茬,到底是詐尸還是另有隱情,我是刑警寧澤彻桃,帶...
    沈念sama閱讀 35,644評論 5 346
  • 正文 年R本政府宣布坛善,位于F島的核電站,受9級特大地震影響叛薯,放射性物質(zhì)發(fā)生泄漏浑吟。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,249評論 3 329
  • 文/蒙蒙 一耗溜、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧省容,春花似錦抖拴、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,866評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至笼蛛,卻和暖如春洒放,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背滨砍。 一陣腳步聲響...
    開封第一講書人閱讀 32,991評論 1 269
  • 我被黑心中介騙來泰國打工往湿, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人惋戏。 一個月前我還...
    沈念sama閱讀 48,063評論 3 370
  • 正文 我出身青樓领追,卻偏偏與公主長得像,于是被迫代替她去往敵國和親响逢。 傳聞我的和親對象是個殘疾皇子绒窑,可洞房花燭夜當晚...
    茶點故事閱讀 44,871評論 2 354

推薦閱讀更多精彩內(nèi)容