使用Webpack 4构建Node库时输出文件过大问题求助

嘿，这个问题我之前折腾Node.js库打包时也碰到过！咱们来一步步拆解原因，再给出针对性的解决办法：

主要有两个核心原因：

• Babel预设的默认行为：如果你用了@babel/preset-env但没明确配置目标环境，它会默认假设你要兼容所有旧环境（包括老浏览器），所以会把所有ES2017+的polyfill全量打包进去。但Node.js本身从10.x版本开始就已经支持大部分ES2017特性了，比如async/await、Object.values这些，根本不需要额外的polyfill。
• Webpack的浏览器导向默认配置：Webpack默认是为前端浏览器环境打包的，它会尝试把Node.js的核心模块（比如util、buffer）也打包进去，而这些在Node.js运行环境里本来就存在，完全没必要打包。

1. 精准配置Babel，只添加必要的polyfill #

修改你的Babel配置文件（比如babel.config.json或.babelrc），明确指定目标Node.js版本，让Babel只补全该版本不支持的特性：

{
  "presets": [
    ["@babel/preset-env", {
      "targets": {
        "node": "14" // 换成你要支持的最低Node.js版本，比如12+
      },
      "useBuiltIns": "usage", // 按需加载polyfill
      "corejs": 3 // 对应你安装的core-js版本，记得先npm install core-js@3
    }]
  ]
}

2. 调整Webpack配置适配Node.js库 #

因为你是构建Node.js库，不是前端应用，一定要修改Webpack的核心配置：

module.exports = {
  mode: 'production', // 开启生产模式，自动压缩代码
  target: 'node', // 告诉Webpack目标环境是Node.js，不打包核心模块
  entry: './src/index.js',
  output: {
    filename: 'index.js',
    libraryTarget: 'commonjs2' // 适配Node.js的模块导出格式
  },
  externals: {
    mongodb: 'commonjs mongodb' // 把mongodb排除在打包外，让用户自行安装
  }
};

这里的externals非常关键——它告诉Webpack：mongodb是一个外部依赖，不需要打包到输出文件里，用户安装你的库时会自己处理这个依赖。

3. 清理不必要的插件 #

如果你的Webpack配置里有针对前端的插件（比如mini-css-extract-plugin、html-webpack-plugin），直接删掉就行，Node.js库根本用不上这些。

做完这些调整后，你的输出文件应该会大幅缩小，只会包含你自己的业务逻辑，多余的polyfill和第三方依赖都会被排除在外～

内容的提问来源于stack exchange，提问作者Łukasz Jagodziński