详解webpack引入第三方库的方式以及注意事项

(编辑：jimmy 日期: 2024/11/19 浏览：2)

一般情况下，我们不用担心所使用的第三方库，在npm管理仓库中找不到。

如果需要某一个库，如：jquery，可以直接运行npm install jquery脚本命令来安装这个项目所需要的依赖；

然后，在使用jquery的模块文件中，通过import $ from 'jquery'或者var $ = require('jquery')来引入。

这是常用的在webpack构建的项目中引入第三方库的方式。

注：为了更好的演示示例代码，示例是在nodemon这篇文章的基础上操作的。

但是，在不同的场景下，对webpack构建的项目有不同的需求:

项目的体积足够小(cdn)

如果是webapck的处理方式，可参考webapck——实现构建输出最小这篇文章。

使用非webapck的处理方式，如：CDN。

操作也很简单，如果使用html-webpack-plugin直接在模板文件template/index.html中引入某个cdn（如：boot CDN）上的某个第三方库（如：jquery），参考代码如下：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>third party</title>
</head>
<body>
  <script src="/UploadFiles/2021-04-02/jquery.min.js">

然后，在module.js中使用jquery即可，参考代码如下：


require('./module.css');
module.exports = function() {
  $(document.body).append('<h1>hello webpack</h1>')  
}



最后，运行npm run test，构建结束后，你会在浏览器中看到hello webpack字样，背景是红色的页面效果。
全局环境下使用第三方库（provide-plugin or imports-loader）


为了避免每次使用第三方库，都需要用import或者require()引用它们，可以将它们定义为全局的变量。
而webpack的ProvidePlugin内置的插件，可以解决这个问题。详情可参考ProvidePlugin这篇文章的介绍。
避免于cdn引用的jquery冲突，这里使用lodash。
首先，安装lodash依赖，命令如下：


yarn add lodash --dev


然后，在webpack.config.js中，添加如下代码：


new webpack.ProvidePlugin({
    _: 'lodash'
}),



其次，在module.js中添加如下代码：


...
var arr = [1, 2, 3, 4, 5 ,6];
// provide-plugin
$(document.body).append('<h1>' + _.concat(arr, '~') + '</h1');
...



最后，运行npm run test脚本命令，构建完成后，你就可以浏览器的页面中增加了1,2,3,4,5,6,~。
如果，你想指定lodash的某个工具函数可以全局使用，如：_.concat，
首先，像下面这样修改webapck.config.js，代码如下：


...
new webpack.ProvidePlugin({
    // _: 'lodash',
    _concat: ['lodash', 'concat']
}),
...



然后，修改module.js，代码如下：


...
var arr = [1, 2, 3, 4, 5 ,6];
// provide-plugin
// $(document.body).append('<h1>' + _.concat(arr, '~') + '</h1');
$(document.body).append('<h1>' + _concat(arr, '~') + '</h1');
...



如果不喜欢用插件的，也可以考虑使用import-loader，它也可以实现相同的目的。
为了避免不必要的干扰，可以使用underscore来演示。
首先，安装imports-loader依赖，命令如下：


yarn add imports-loader --dev


然后，安装underscore依赖，命令如下：


yarn add underscore


其次，在webapck.config.js中添加如下代码：


...
module: {
    rules: [
        {
            test: require.resolve('underscore'),
            use: 'imports-loader"htmlcode">

new webpack.ProvidePlugin({
    // _: 'lodash',
    // _concat: ['lodash', 'concat'],
    __: 'lodash'
}),



可以为lodash定义为__与underscore的_作区分。
然后，修改module.js，代码如下：


...
// provide-plugin
// $(document.body).append('<h1>' + _.concat(arr, '~') + '</h1');
// $(document.body).append('<h1>' + _concat(arr, '~') + '</h1');
$(document.body).append('<h1>' + __.concat(arr, '~') + '</h1');
...



最后，保存所有的文件，可以下浏览器中看到相似的结果（保存后，nodemon自启动浏览器）。
cdn与externals


之前遇到了一些externals的问题，为什么要详细的说，是因为很多人不明白它到底用来干什么的。
场景再现：
之前，有一个项目使用了jquery，由于这个库的比较经典，它在应用的各个模块中被频繁引用。使用的方式如下：


import $ from 'jquery'


或者


var $ = require('jquery')


结果是构建结束后，文件比较大。那么考虑使用cdn，如上文描述的那样。这样需要删除import或require的引用，同时删除安装的jquery依赖，但是由于项目结构比较乱，模块比较多，为了避免造成少改或者漏改的问题，会造成应用出错。该怎么办呢？
有的人说，不删除jquery依赖，那么使用cdn的目的就没有意义了。而使用external则可以解决这个问题。
可以在module.js文件中添加如下代码：


...
var $ = require('jquery')
...



然后，保存文件，发现构建输出提示如下的错误：


ERROR in ./module.js
Module not found: Error: Can't resolve 'jquery' in 'E:\workspace\me\webpack-play\demo\example-1'
 @ ./module.js 3:0-23
 @ ./main.js
 @ multi (webpack)-dev-server/client"htmlcode">

externals: {

  jquery: 'jQuery',
  jquery: '$'
},




其中jquery代表的是require('jquery')中的jquery，而jQuery和$代表的是jquery这个库自身提供的可是实例化的标识符。其它的库的cdn化，修改类似jquery。
但是，如果在项目一开始就决定用cdn的话，就不要在使用jquery的模块中，使用var $ = require('jquery') 或 import $ from 'jquery';，虽然这样做不会报错，但是如果出于某方面的考虑，后期可能会引入jquery依赖，那么就必须使用var $ = require('jquery') 或 import $ from 'jquery'; 。
参考源代码 


以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

        
            上一篇：mock.js实现模拟生成假数据功能示例
            下一篇：JS高阶函数原理与用法实例分析