TypeScript 中的 baseUrl

说明 baseUrl 的历史用途、它如何影响裸模块解析，以及为什么现代项目通常应减少对它的依赖。

#tech / dev #resource / typescript #type / concept #status / growing

[!info] related notes

所属 MOC: TypeScript MOC

配置入口: tsconfig 使用详解

并列概念: TypeScript 中的 paths

关系笔记: TypeScript 中的 baseUrl 与 paths

一句话定义

baseUrl 会给裸模块导入提供一个额外查找根目录。

如果配置：

{
  "compilerOptions": {
    "baseUrl": "./src"
  }
}

那么：

import { foo } from "utils/foo";

会尝试按 src/utils/foo 继续解析。

baseUrl 最常见的旧用途是：

它会真实参与模块解析优先级。

官方文档说明：

如果只是压掉提示，可以设置 ignoreDeprecations: "6.0"，但这不代表项目已经摆脱了对 baseUrl 的真实依赖。