Rsbuild 默认支持 TypeScript,你可以直接在项目中使用 .ts
和 .tsx
文件。
Rsbuild 默认使用 SWC 来转译 TypeScript 代码,也支持切换到 Babel 进行转译。
与 TypeScript 原生编译器不同,像 SWC 和 Babel 这样的工具会将每个文件单独编译,它无法确定导入的名称是一个类型还是一个值。因此,当你在 Rsbuild 中使用 TypeScript 时,需要启用 tsconfig.json
中的 isolatedModules 选项:
该选项可以帮助你避免使用一些 SWC 和 Babel 无法正确编译的写法,比如跨文件的类型引用问题,它会引导你更正对应的用法:
在进行 TypeScript 转译时,SWC 和 Babel 等工具不会执行类型检查。
Rsbuild 提供了 Type Check 插件,用于在单独的进程中运行 TypeScript 类型检查,插件内部集成了 fork-ts-checker-webpack-plugin。
请参考 Type Check 插件 了解用法。
Rsbuild 默认读取根目录的 tsconfig.json
文件,你可以使用 source.tsconfigPath 配置自定义的 tsconfig.json 文件路径。