TypeScript中混合ES6 import与CommonJS require及条件导入问题

安全阿岳

2026-5-15

关于TypeScript中条件导入与模块混用的问题解答

问题1：在TypeScript文件中混合使用ES6的import和CommonJS的require是否属于良好实践？

其实在TypeScript里混合用import和require不能直接说绝对不好，但确实不推荐作为常规操作。原因主要有几点：

首先，这会让代码风格不统一，团队协作时容易产生混乱——毕竟ES模块（import/export）是TS和现代JS的标准模块系统，CommonJS的require属于旧规范。
其次，TS的类型检查对import的支持更完善，require加载的模块如果没有类型声明，很容易出现类型缺失的问题；而且TS编译器在处理两种模块混合时，偶尔会有解析上的小冲突，比如模块解析策略不一致。
不过也有例外情况，比如你这种条件性的副作用导入（只需要模块执行初始化逻辑，不需要用到它的导出内容），临时用require是可以接受的，但尽量还是用TS推荐的标准方案替代。

对于这种只需要触发模块副作用（比如newrelic加载后会自动初始化监控）的条件导入，TS有几种更标准的方案：

动态import()语法：这是ES标准的动态导入方式，TS完全支持，而且可以放在条件语句里。你可以改成这样：
```
import * as someModule from 'someModule';

async function initApp() {
  if (config.get('newrelic')) {
    await import('newrelic'); // 不需要接收导出内容，只执行模块的初始化逻辑
  }
  // 这里写应用的其他初始化逻辑
}

initApp();
```
注意动态import返回的是Promise，所以需要用async/await处理，或者用.then()链式调用。如果你的代码是在入口文件，这种方式完全可行，而且完全符合ES模块规范。
Node.js环境下用createRequire：如果你需要同步加载模块，也可以用Node.js官方提供的createRequire方法来创建CommonJS的require函数，这也是TS认可的写法：
```
import { createRequire } from 'module';
const require = createRequire(import.meta.url);

if (config.get('newrelic')) {
  require('newrelic');
}
```
这种方式既符合ES模块的规范，又能实现同步的条件加载，适合对初始化顺序有要求的场景。

要解决TSlint的no-var-requires错误，有几种实用的办法：

改用动态import()：这是最根本的解决方式，因为动态import是ES标准，TSlint不会对它报错，同时也符合现代模块规范，也就是上面提到的第一种方案。
临时禁用TSlint规则：如果一定要用require，可以在需要的代码行上方添加注释来临时禁用该规则：
```
// tslint:disable-next-line:no-var-requires
require('newrelic');
```
不过这种方式只适合临时场景，不推荐长期使用——毕竟规则存在的意义就是为了规范代码风格。
使用createRequire代替直接require：像问题2里提到的，用Node.js的createRequire创建合法的require函数，TSlint会认可这种写法，不会抛出错误，同时也能保持代码的规范性。

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