TypeScript项目中解决require语句引发的模块导入错误

在TypeScript项目开发过程中，很多开发者习惯使用CommonJS风格的require语句导入模块，但经常会遇到模块导入相关的类型错误或者运行时找不到模块的问题。本文将详细介绍这类错误的常见原因和对应的解决方法。

常见错误表现

使用require导入模块时，最常见的错误提示有两种：一种是TypeScript编译阶段报出的Cannot find name 'require'错误，另一种是运行时提示module not found的错误。下面我们分别针对这两种场景给出解决方案。

解决Cannot find name 'require'错误

出现这个错误的原因是TypeScript默认没有识别CommonJS的require语法，需要安装对应的类型声明包来让TypeScript识别相关语法。

步骤1：安装@types/node类型包

Node.js内置的模块相关的类型声明都包含在@types/node包中，执行以下命令安装：

# 使用npm安装
npm install @types/node --save-dev
# 使用yarn安装
yarn add @types/node --dev

步骤2：配置tsconfig.json

安装完成后，需要在tsconfig.json的compilerOptions中添加@types/node到类型声明列表中，确保TypeScript能够加载对应的类型：

{
  "compilerOptions": {
    "target": "ES6",
    "module": "commonjs",
    "types": ["node"],
    "strict": true,
    "esModuleInterop": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

配置完成后，require语句就可以被TypeScript正确识别，不会再报找不到名称的错误。

解决运行时module not found错误

如果编译阶段没有报错，但是运行时提示找不到模块，通常是路径或者模块导出方式的问题。

场景1：导入自定义本地模块

使用require导入本地自定义模块时，需要保证路径正确，且模块有正确的导出。比如我们有一个本地工具模块src/utils/format.ts，内容如下：

// src/utils/format.ts
// 使用CommonJS方式导出
function formatDate(date: Date): string {
  return date.toLocaleDateString();
}

module.exports = {
  formatDate
};

在其他文件中导入时，需要写对相对路径：

// src/index.ts
// 导入本地模块，路径相对于当前文件
const { formatDate } = require('./utils/format');

const now = new Date();
console.log(formatDate(now));

场景2：导入第三方npm包

如果导入的是第三方包提示找不到模块，首先检查是否已经安装该包，其次确认包是否有正确的类型声明。如果第三方包没有提供类型声明，可以手动创建声明文件，比如导入foo包没有类型时，在src/types/foo.d.ts中声明：

// src/types/foo.d.ts
declare module 'foo' {
  // 根据实际包的导出内容补充类型
  const foo: any;
  export default foo;
}

然后在tsconfig.json的include中添加类型文件目录：

{
  "include": ["src/**/*", "src/types/**/*"]
}

更推荐的模块导入方式

虽然可以通过配置让require正常工作，但TypeScript本身更推荐ES模块的导入语法，配合esModuleInterop配置可以兼容CommonJS模块。建议尽量使用import语法代替require：

// 使用ES模块导入语法，兼容性更好
import { formatDate } from './utils/format';

// 导入CommonJS导出的第三方包也可以正常识别
import express from 'express';
const app = express();

只要在tsconfig.json中开启esModuleInterop: true和module: "commonjs"，这种写法既符合TypeScript的类型检查要求，也能在编译后正确转换为CommonJS代码，减少模块导入相关的问题。

总结

TypeScript中使用require语句的导入错误，大多可以通过安装@types/node、正确配置tsconfig.json、检查模块路径和导出方式来解决。如果项目没有特殊的历史代码兼容需求，优先使用ES模块的import语法能更高效地避免这类问题，提升开发体验。

TypeScriptrequire错误模块导入tsconfig配置@types/node 本作品最后修改时间：2026-05-22 14:41:18