该文章内容已过时

三斜线指令

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

三斜线指令仅可放在包含它的文件的最顶端

一个三斜线指令的前面只能出现单行或多行注释,这包括其它的三斜线指令

如果它们出现在一个语句或声明之后,那么它们会被当做普通的单行注释,并且不具有特殊的含义

使用三斜线指令时,tsconfig不能设置"moduleDetection": "force"

更推荐使用import引入文件,而不是使用三斜线指令

三斜线引用

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

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

a.ts:

1
2
3
namespace A {
export const fn = () => 'a'
}

b.ts:

1
2
3
namespace A {
export const fn2 = () => 'b'
}

index.ts:引入后可直接使用命名空间A

1
2
3
///<reference path="./a.ts" />
///<reference path="./b.ts" />
console.log(A);

声明文件引入

例如把

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

引入到声明文件,表示这个文件使用了 @types/node/index.d.ts里面声明的名字,且这个包需要在编译阶段与声明文件一起被包含进来

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