使用webpack和lodash捆绑依赖库

Question

我在这里需要帮助。我捆绑了一个自定义库（以示例LibraryJS命名，它使用lodash作为依赖项。

在webpack配置中，我将lodash设置为外部依赖项，如下所示：

{
   externals: {
       "lodash"
   }
}

效果很好。但是，当我想在另一个项目中使用该库时，出现以下错误：“ libraryjs.js：77 Uncaught ReferenceError：未定义lodash ”

这是以下行：

/***/ }),
/* 1 */
/***/ (function(module, exports) {

=> module.exports = lodash;

/***/ }),

事实是，我在项目中也使用lodash，因此它应该可以正常工作。我究竟做错了什么？

顺便说一句，我正在使用gulp + browserify捆绑我的项目，并使用gulp + gulp-webpack捆绑了图书馆。

编辑：我找到了一种修复错误的方法，但我真的不想坚持使用此修复程序，因为它的确是...丑陋的。

const lodash = require('lodash')
window.lodash = lodash; // <= The fix, ugh

感谢您的帮助！

Answer 1

在尝试构建库时，我遇到了类似的情况-这是我找到的解决方案。

目标： 建立一个依赖Lodash的库，而不将Lodash包含在该库包中。图书馆的使用者有责任使Lodash可供我们的图书馆使用。

我使用了文档的“ 编写库”部分来组合此解决方案。

特别是这两部分：

• 外部化Lodash
• 揭露图书馆

还有一个示例项目也显示了此配置：https : //github.com/webpack/webpack/tree/master/examples/externals

解：

1.捆绑我们的图书馆，不包括lodash

// "my-lib" package.json
{
    "name": "my-lib",
    "version": "0.5.0",
    "main": "my-lib.js",
    "peerDependencies": {
        "lodash": "^4.17.5"
    },
    "devDependencies": {
        "webpack": "^4.5.0",
        "webpack-cli": "^2.0.14"
    }
}

这是导入lodash并使用它的示例库。请注意，尽管我们依赖lodash，但它不会包含在我们的捆绑包中。

// lib-entry.js
import _ from "lodash";

export default function doubleUp(listOfNum){
    // Do something using lodash
    let result = _.flatMap(listOfNum, (i) => [i, i]);
    return result;
}

这webpack.config.js是捆绑我们的库的东西，但不包括lodash：

// "my-lib" webpack.config.js
module.exports = {
    entry: {
        'my-lib': './lib-entry.ts', 
    },
    output: {
        filename: '[name].js',

        // [1]
        libraryTarget: 'umd',

        /*
        [2]
        NOTE: until this issue is fixed: https://github.com/webpack/webpack/issues/6525
        we need to define `globalObject` in Webpack 4 to correctly build a universal library
        (i.e. node and browser compatible).
        */
        globalObject: 'this',
    },
    externals: {
        // [3]
        'lodash': {
            commonjs: 'lodash',
            commonjs2: 'lodash',
            amd: 'lodash',
            root: '_',
        },
    },
    resolve: {
        extensions: ['.js'],
    },
};

[1]这告诉Webpack为不同的环境捆绑我们的库（因此它可以通过以下方式加载：浏览器脚本，Node CommonJS，AMD和下游Webpack项目）。注意：这是必需的，否则externals[3]中的配置将undefined在您的软件包中输出不正确的模块。

[2] Webpack 4错误的解决方法（如果您将来使用，请检查是否仍然相关并需要）。在此处也进行了描述：https : //stackoverflow.com/a/49119917/81723

[3]从文档中：“设置externals选项以定义应在目标环境中解决的依赖项”。我们要告诉Webpack从库包中排除lodash，我们的库的使用者有责任提供它。

2.在下游应用程序中使用该库

定义一个依赖我们my-lib库的应用程序：

// "my-app" package.json
{
    "name": "my-app",
    "version": "1.0.0",
    "dependencies": {
        "lodash": "^4.17.5",
        "my-lib": "^0.5.0"
    },
    "devDependencies": {
        "webpack": "^4.5.0",
        "webpack-cli": "^2.0.14"
    }
}

我们的应用程序将lodash导入其环境中（因为我们的库需要它），然后使用我们的库：

// app-entry.js
import _ from "lodash";
import doubleUp from "my-lib";

let result = doubleUp([1, 2, 3]);
console.log(result);    // [1, 1, 2, 2, 3, 3]

这是webpack.config.js我们的应用程序：

// "my-app" webpack.config.js
const path = require('path');

module.exports = {
    entry: {
        'my-app': './app-entry.ts', 
    },
    output: {
        filename: '[name].js',
    },
    resolve: {
        extensions: ['.js'],
        alias: {
            /*
            [1]
            Resolve all `lodash` requests to the same location otherwise
            we end up with two versions loaded into the bundle, one
            for `my-lib` and one for `my-app`.
            */
            lodash: path.resolve('./node_modules/lodash/index.js'),
        }
    },
};

[1]此alias配置意味着Webpack遇到任何时间require('lodash')，import ... from "lodash";否则它将解析为磁盘上的该模块。我发现我必须这样做，以避免将多个版本的lodash加载到我的捆绑包中。Webpack包括一个用于的版本my-app，一个用于的版本my-lib，但这已对其进行了修复，以使二者都具有相同的版本。