请解释 TypeScript 中的模块解析 (Module Resolution) 策略。如何配置模块解析选项？

推荐答案

TypeScript 中的模块解析策略决定了编译器如何查找和解析模块。TypeScript 支持两种主要的模块解析策略：Classic 和 Node。

• Classic：这是 TypeScript 早期的默认模块解析策略。它相对简单，主要适用于 AMD 和 SystemJS 模块系统。
• Node：这是 TypeScript 1.6 之后的默认模块解析策略。它模拟了 Node.js 的模块解析机制，适用于 CommonJS 和 ES6 模块系统。

配置模块解析选项

在 tsconfig.json 文件中，可以通过 moduleResolution 选项来配置模块解析策略。例如：

{
  "compilerOptions": {
    "moduleResolution": "node" // 或 "classic"
  }
}

本题详细解读

模块解析策略

Classic 策略

• 相对路径：对于相对路径的模块导入（如 ./moduleA），TypeScript 会直接在相对路径下查找 .ts 或 .d.ts 文件。
• 非相对路径：对于非相对路径的模块导入（如 moduleA），TypeScript 会从包含导入文件的目录开始，逐级向上查找 node_modules 目录，直到找到匹配的模块。

Node 策略

• 相对路径：与 Classic 策略类似，TypeScript 会直接在相对路径下查找 .ts 或 .d.ts 文件。
• 非相对路径：TypeScript 会模拟 Node.js 的模块解析机制，首先在当前目录的 node_modules 中查找模块，如果没有找到，则逐级向上查找父目录的 node_modules，直到找到匹配的模块。此外，Node 策略还会考虑 package.json 中的 main 字段和 types 字段。

模块解析的扩展

TypeScript 还支持通过 paths 和 baseUrl 选项来进一步自定义模块解析路径。例如：

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

在这个配置中，所有以 @app/ 开头的模块导入都会被解析到 ./src/app/ 目录下。

模块解析的优先级

1. 相对路径：优先解析相对路径的模块。
2. 非相对路径：根据配置的模块解析策略（Classic 或 Node）进行解析。
3. 自定义路径：如果配置了 paths 和 baseUrl，TypeScript 会优先使用这些配置进行模块解析。

通过合理配置模块解析策略，可以更好地管理项目中的模块依赖关系，提高代码的可维护性和可读性。