使用esbuild打包Node.js/Express项目出现重复导入问题咨询

这是esbuild在--packages=external+--format=esm配置组合下的正常行为，并非构建脚本错误，下面具体说明：

为什么会出现重复导入？ #

你添加的--packages=external会把所有npm包（包括express）标记为外部依赖，esbuild不会将它们的代码打包进bundle，而是保留每个源文件中原本的导入逻辑。同时因为你指定了--format=esm，而express本身是CommonJS模块，esbuild为了兼容ESM对CommonJS的导入规则，会为每个原文件里的express导入生成独立的import语句，并通过重命名变量（express、express2、express3）来避免作用域冲突。

这里要明确：虽然看起来有多个导入语句，但Node.js的模块缓存机制会确保express只会被加载一次，完全不会影响运行性能，只是代码观感上不够简洁。

如何实现单处导入？ #

有两种方案可选：

• 去掉--packages=external选项：让esbuild把express的代码打包进bundle，这时候esbuild会自动合并所有重复的导入，最终只保留一处express相关的代码。缺点是bundle体积会变大，但后端项目通常对此不敏感。
• 自定义esbuild插件处理（复杂）：如果必须保留express为外部依赖，可以编写插件收集所有express的导入语句，在打包阶段替换为单个导入。不过这种方式性价比不高，因为多个导入本身不影响运行。

内容的提问来源于stack exchange，提问作者MRT