前言

TypeScript是Javascript的超集，實(shí)現(xiàn)以面向?qū)ο缶幊痰姆绞绞褂肑avascript。當(dāng)然最后代碼還是編譯為Javascript。

三斜杠指令是包含單個(gè)XML標(biāo)記的單行注釋。 注釋的內(nèi)容用作編譯器指令。

三斜杠指令僅在其包含文件的頂部有效。 三重斜杠指令只能在單行或多行注釋之前，包括其他三重斜杠指令。 如果在聲明或聲明之后遇到它們，則將它們視為常規(guī)單行注釋，并且沒有特殊含義。

/// <reference path ="..."/>

/// <reference path ="..."/>指令是該組中最常見的。 它充當(dāng)文件之間的依賴聲明。

三斜杠引用指示編譯器在編譯過程中包含其他文件。

它們還可以作為在使用–out或–outFile時(shí)對輸出進(jìn)行排序的方法。 在預(yù)處理傳遞之后，文件以與輸入相同的順序發(fā)送到輸出文件位置。

該過程從一組根文件開始; 這些是在命令行或tsconfig.json文件的”files”列表中指定的文件名。 這些根文件按照指定的順序進(jìn)行預(yù)處理。 在將文件添加到列表之前，將處理其中的所有三重斜杠引用，并包括其目標(biāo)。 三重斜杠引用按照它們在文件中看到的順序以深度優(yōu)先方式解析。

如果無根則，則相對于包含文件解析三斜杠參考路徑。

錯(cuò)誤

引用不存在的文件是錯(cuò)誤的。 如果文件具有對自身的三斜杠引用，則會出錯(cuò)。

使用–noResolve

如果指定了編譯器標(biāo)志–noResolve，則忽略三次斜杠引用; 它們既不會導(dǎo)致添加新文件，也不會更改所提供文件的順序。

/// <reference types="..." />

類似于/// <reference path ="..."/>指令，該指令用作依賴聲明; 但是， /// <references types ="..."/>指令聲明了對包的依賴性。

解析這些包名稱的過程類似于在import語句中解析模塊名稱的過程。 考慮三重斜杠引用類型指令的簡單方法是作為聲明包的導(dǎo)入。

例如，在聲明文件中包含/// <references types ="node"/>聲明此文件使用在types/node/index.d.ts中聲明的名稱; 因此，此包需要與聲明文件一起包含在編譯中。

只有在手動創(chuàng)建d.ts文件時(shí)才使用這些指令。

對于編譯期間生成的聲明文件，編譯器會自動為您添加/// <references types ="..."/>; 當(dāng)且僅當(dāng)生成的文件使用引用包中的任何聲明時(shí)，才會添加生成的聲明文件中的/// <reference types ="..."/> 。

/// <reference lib="..." />

該指令允許文件顯式包含現(xiàn)有的內(nèi)置lib文件。

內(nèi)置的lib文件以與tsconfig.json中的”lib”編譯器選項(xiàng)相同的方式引用（例如，使用lib=”es2015”而不是lib=”lib.es2015.d.ts”等）。

對于在內(nèi)置類型上進(jìn)行中繼的聲明文件作者，例如 建議使用DOM API或內(nèi)置的JS運(yùn)行時(shí)構(gòu)造函數(shù)（如Symbol或Iterable，三斜杠引用lib指令）。 以前這些.d.ts文件必須添加此類型的前向/重復(fù)聲明。