Lerna Monorepo环境下Webpack 5加载包外文件问题求助

算力阿峰

2026-4-30

解决Webpack 5在Monorepo中意外触发GitHub Packages依赖的TypeScript/ESLint错误

看起来你遇到的问题核心并不是Webpack实际打包时加载了不该引入的依赖，而是你的代码检查工具（ForkTsCheckerWebpackPlugin和ESLintPlugin）在扫描文件时，错误地包含了node_modules里那个GitHub Packages的包，进而抛出了它内部的TypeScript错误。即使你简化了入口文件，这些检查器依然会遍历符合扩展名的文件，包括第三方依赖里的TS文件。

下面是针对性的解决方案：

1. 让TypeScript检查器排除node_modules

你的ForkTsCheckerWebpackPlugin目前没有配置exclude规则，它默认会扫描项目中所有.ts/.tsx文件，包括node_modules里的。修改配置，明确排除第三方依赖：

new ForkTsCheckerWebpackPlugin({
  async: false,
  exclude: /node_modules/, // 添加这一行，排除所有node_modules文件
}),

2. 让ESLint排除node_modules

同样，你的ESLintPlugin也没有设置排除规则，ESLint会尝试lint所有匹配扩展名的文件，包括依赖包。更新配置：

new ESLintPlugin({
  extensions: ["js", "jsx", "ts", "tsx"],
  exclude: /node_modules/, // 添加这一行，跳过node_modules的lint检查
}),

3. 验证第三方包的编译状态

另外，确认你安装的@githubpackage是否正确编译为JavaScript发布：

查看它的package.json，确保main/module字段指向的是编译后的.js文件，而不是源.ts文件。
如果该包没有编译就发布，即使排除了检查，Webpack在解析时可能还是会尝试处理TS文件（虽然你的tsRules已经排除了node_modules，但仍可能有潜在问题）。这种情况下，你需要联系包的维护者修复发布流程，或者在本地通过patch-package临时处理。