前言
TypeScript是Javascript的超集,实现以面向对象编程的方式使用Javascript。当然最后代码还是编译为Javascript。
三斜杠指令是包含单个XML标记的单行注释。 注释的内容用作编译器指令。
三斜杠指令仅在其包含文件的顶部有效。 三重斜杠指令只能在单行或多行注释之前,包括其他三重斜杠指令。 如果在声明或声明之后遇到它们,则将它们视为常规单行注释,并且没有特殊含义。
///
/// 指令是该组中最常见的。 它充当文件之间的依赖声明。
三斜杠引用指示编译器在编译过程中包含其他文件。
它们还可以作为在使用–out或–outFile时对输出进行排序的方法。 在预处理传递之后,文件以与输入相同的顺序发送到输出文件位置。
该过程从一组根文件开始; 这些是在命令行或tsconfig.json文件的”files”列表中指定的文件名。 这些根文件按照指定的顺序进行预处理。 在将文件添加到列表之前,将处理其中的所有三重斜杠引用,并包括其目标。 三重斜杠引用按照它们在文件中看到的顺序以深度优先方式解析。
如果无根则,则相对于包含文件解析三斜杠参考路径。
错误
引用不存在的文件是错误的。 如果文件具有对自身的三斜杠引用,则会出错。
使用–noResolve
如果指定了编译器标志–noResolve,则忽略三次斜杠引用; 它们既不会导致添加新文件,也不会更改所提供文件的顺序。
///
类似于/// 指令,该指令用作依赖声明; 但是, /// 指令声明了对包的依赖性。
解析这些包名称的过程类似于在import语句中解析模块名称的过程。 考虑三重斜杠引用类型指令的简单方法是作为声明包的导入。