编译器配置项-compilerOptions

模块相关（一）

允许任意文件扩展名-allowArbitraryExtensions

在 TypeScript 5.0 中，当导入的文件以非已知 JavaScript 或 TypeScript 文件扩展名结尾时，TypeScript编译器将查找该文件的声明文件（{file basename}.d.{extension}.ts ）。例如，如果在需要打包器打包的程序项目中使用CSS loader，那么需要为这些样式表编写（或生成）声明文件：

/* app.css */
.cookie-banner {
  display: none;
}

// app.d.css.ts
declare const css: {
  cookieBanner: string;
};
export default css;

// App.tsx
import styles from "./app.css";
styles.cookieBanner; // string

默认情况下，导入css文件将报告错误：TypeScript无法理解文件类型并且运行时可能不支持。但是，如果已经在运行时或者打包时配置了支持css文件导入，那么可以通过配置allowArbitraryExtensions来避免该错误。

注意：历史上实现类似效果，是通过添加类型声明文件app.css.d.ts，而不是app.d.css.ts，但是这只在Node的CommonJS中的require中生效。严格说来app.css.d.ts才可以解释为app.css.js文件的TypeScript的声明文件。由于Node支持的ESM在导入相对文件时需要包含文件扩展名，在我们的ESM类型的文件示例中TypeScript将报错。

允许导入TS文件扩展名-allowImportingTsExtensions

allowImportingTsExtensions允许TypeScript文件互相导入通过TypeScript特定文件扩展名.ts、.mts或者.tsx。

这个配置项仅当noEmit或者emitDeclarationOnly

仅当启用 --noEmit 或 --emitDeclarationOnly 时才允许使用此配置项，因为这些导入的文件在JavaScript运行时将无法被解析。这个配置项的目的是使解析器（例如您的捆绑器、运行时或其他一些工具）在.ts文件互相导入时正常工作。如果没有此标志，使用 UMD 模块的exports需要导入声明文件。

允许 Umd 全局访问-allowUmdGlobalAccess

当allowUmdGlobalAccess设置为 true 时，导入UMD的exports将在当前文件内部作为全局变量。具有import或者exports语句的文件时一个模块。如果未配置allowUmdGlobalAccess，使用 UMD 模块的exports需要先导入它的声明。

该选项可以在这个典型的示例中使用，一个指定库（如 jQuery 或 Lodash）在Web 项目运行时始终可用，但是却无法通过import导入。