编译器配置项-compilerOptions
操作约束相关配置项02
强制文件名大小写一致 - forceConsistentCasingInFileNames
对于文件的大小写规则,TypeScript默认与文件系统保持一直。如果一些开发人员在区分大小写的文件系统中工作(linux),而其他开发人员在不区分大小写的文件系统上工作(windows),这可能会出现问题。如果尝试通过指定 ./FileManager.ts
导入 fileManager.ts
文件,那么该文件将在不区分大小写的文件系统中被找到,而在区分大小写的文件系统中不会被找到。
启用该选项后,如果代码中使用与磁盘上文件大小写字符不一致的文件名导入该文件,TypeScript 将发出错误消息。
隔离类型声明 - isolatedDeclarations
对导出对象添加充足的注释,以便其他工具可以轻松生成声明文件。
隔离模块 - isolatedModules
虽然您可以使用 TypeScript 从 TypeScript 代码生成 JavaScript 代码,但使用 Babel 等其他转译器来执行此操作也很常见。然而,其他转译器一次只能操作一个文件,这意味着它们无法依赖于理解完整类型系统下进行代码的转换。此限制也适用于那些使用TypeScript模块API方法 ts.transpile
的构建工具 。
这些限制可能会导致某些 TypeScript 功能(例如 const enum
和namespace
)出现运行时问题。设置isolatedModules
标志告诉TypeScript在你编写的某些代码无法被单文件转译进程正确解释时发出警告。
它不会改变代码的行为,也不会改变 TypeScript 检查和输出内容进程的行为。
下边是启用isolatedModules
时无效代码的示例。
导出未定义的值时
在 TypeScript 中,您可以导入类型,然后将其导出:
import { someType, someFunction } from "someModule";
someFunction();
export { someType, someFunction };
因为 someType
没有值,所以输出export
时不会尝试导出它(这将会在 JavaScript 运行时产生错误):
export { someFunction };
单文件转译器不知道 someType
是否被定义,因此导出仅引用类型的名称是错误的。
非模块文件
如果设置了isolatedModules
,namespace
仅在模块中被允许使用(这意味着它具有某种形式的 import
/export
)。如果在非模块文件中找到namespace
,则会发生错误:
namespace Instantiated {
Namespaces are not allowed in global script files when 'isolatedModules' is enabled. If this file is not intended to be a global script, set 'moduleDetection' to 'force' or add an empty 'export {}' statement.
export const x = 1;
}
这个不适用于 .d.ts
文件。
引用常量枚举成员
在 TypeScript 中,当您引用 const enum
成员时,在输出的JavaScript代码中该引用将被实际值替换。例如以下TypeScript代码:
declare const enum Numbers {
Zero = 0,
One = 1,
}
console.log(Numbers.Zero + Numbers.One);
将输出 JavaScript代码如下:
"use strict";
console.log(0 + 1);
如果不知道这些枚举成员的值,那么其他转译器就无法将枚举成员替换为 Numbers
。如果不进行替换的话,这将会产生运行时错误(因为运行时没有Numbers
对象)。因此,当设置isolatedModules
时,引用环境常量枚举成员将会产生错误。