TypeScript 模块解析机制

1. 模块解析的概念

模块解析是指编译器在编译过程中根据模块的导入语句找到并加载相应的模块文件的过程。在 TypeScript 中，模块可以使用相对路径或者绝对路径来导入，编译器需要根据导入语句中的路径信息来定位到对应的模块文件。

2. 解析策略

TypeScript 提供了多种模块解析策略，主要包括：

• 相对路径解析：根据导入语句中的相对路径来查找模块文件。
• 绝对路径解析：根据导入语句中的绝对路径或者基于配置文件（比如 tsconfig.json）中的 baseUrl 来查找模块文件。
• 模块路径映射解析：通过配置文件中的路径映射（paths）来将导入语句中的模块路径映射到实际的文件路径。

3. 解析规则

在进行模块解析时，TypeScript 遵循一定的解析规则，主要包括：

• 查找过程：编译器会根据导入语句中的路径信息以及解析策略来逐级查找模块文件，直到找到对应的文件或者抛出错误。
• 解析优先级：编译器会根据配置文件中的解析策略来确定模块解析的优先级，通常优先级较高的配置会覆盖优先级较低的配置。

4. 示例

假设有一个 TypeScript 项目，目录结构如下：

src/
  |- utils/
  |   |- math.ts
  |- app.ts
tsconfig.json

其中 math.ts 文件定义了一些数学函数，app.ts 文件中导入了 math.ts 中的函数。我们可以通过配置 tsconfig.json 文件中的 baseUrl 和 paths 来配置模块解析的策略。

{
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@utils/*": ["utils/*"]
    }
  }
}

在 app.ts 文件中可以这样导入 math.ts 中的函数：

import { add } from './utils/math'; // 相对路径解析
import { add } from '@utils/math';   // 模块路径映射解析