TypeScript项目中require与import获取类型不一致的原因及优先选型建议

这是TypeScript处理不同模块系统导入时的典型差异，我来帮你理清楚背后的原因和最佳实践：

一、差异产生的原因 #

1. 模块系统的语法适配不同 #

require()是Node.js传统的CommonJS导入语法，而import是ES模块（ECMAScript Modules）的标准语法。TypeScript对这两种语法的类型处理逻辑有明显区别：

• 当你直接用var exec = require('child_process')时，这是纯JavaScript风格的CommonJS导入，TypeScript默认不会自动关联对应的类型声明（即使你已经安装了@types/node），所以会把exec推断为any类型。
• 而import ch from 'child_process'是ES模块的导入方式，TypeScript会主动读取@types/node中为ES模块准备的类型定义，因此能正确识别ch的类型为child_process模块的完整类型。

2. TypeScript的CommonJS类型推荐语法 #

如果要在TypeScript中用CommonJS风格导入并获取正确类型，需要使用TypeScript专门设计的兼容语法：

import exec = require('child_process');
// 此时exec会拥有正确的child_process模块类型

这种语法能让编译器正确关联模块的类型声明，避免any类型的问题。

二、项目中优先使用哪种导入方式？ #

优先选择ES模块的import语法，原因如下：

• 更完善的类型支持：无需额外语法，就能自动获取模块的完整类型，避免any类型带来的类型安全隐患。
• 符合标准趋势：ES模块是JavaScript的官方标准，Node.js从v12开始就支持ES模块，现在已经成为前端和Node.js项目的主流选择。
• 更好的工具链支持：打包工具（如Webpack、Vite）和代码检查工具对ES模块的优化和支持更完善，比如静态分析、树摇（Tree Shaking）等。
• 统一代码风格：使用ES模块语法可以让前端和Node.js代码风格保持一致，降低团队协作的学习成本。

如果你的项目目前仍需要兼容CommonJS（比如依赖大量旧版CommonJS模块），推荐使用TypeScript的import = require()语法来获取正确类型，避免直接使用纯JS风格的require()赋值。

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