三斜线指令

三斜线指令是包含单个XML标签的单行注释。 注释的内容会做为编译器指令使用。

三斜线指令仅可放在包含它的文件的最顶端。 一个三斜线指令的前面只能出现单行或多行注释,这包括其它的三斜线指令。 如果它们出现在一个语句或声明之后,那么它们会被当做普通的单行注释,并且不具有特殊的涵义。

/// <reference path="..." />指令是三斜线指令中最常见的一种。 它用于声明文件间的 依赖。

三斜线引用告诉编译器在编译过程中要引入的额外的文件。

你也可以把它理解能import,它可以告诉编译器在编译过程中要引入的额外的文件

// a.ts
namespace A {
    export const fn = () => 'a'
}
// b.ts
namespace A {
    export const fn2 = () => 'b'
}
// index.ts
/// <reference path="./a.ts" />
/// <reference path="./b.ts" />

console.log(A)

声明文件引入

例如,把 /// <reference types="node" />引入到声明文件,表明这个文件使用了 @types/node/index.d.ts里面声明的名字; 并且,这个包需要在编译阶段与声明文件一起被包含进来。

仅当在你需要写一个d.ts文件时才使用这个指令。

/// <reference types="node" />

注意事项:如果你在配置文件 配置了noResolve 或者自身调用自身文件会报错

贡献者: mankueng