订阅专栏

Do’s and Don’ts

永远不要使用类型 Number、String、Boolean、Symbol 或 Object. 这些类型是指几乎从未在 JavaScript 代码中正确使用的非原始装箱对象。

下列用法不推荐：

function reverse(s: String): String;

应该使用下列用法：

function reverse(s: string): string;

any

除非您正在将 JavaScript 项目迁移到 TypeScript，否则不要使用 any 作为类型。 编译器有效地将 any 视为“请关闭此内容的类型检查”。 它类似于在变量的每个用法周围放置@ts-ignore 注释。 当您第一次将 JavaScript 项目迁移到 TypeScript 时，这会非常有用，因为您可以将尚未迁移的内容的类型设置为任何类型，但是在完整的 TypeScript 项目中，您将禁用对程序的任何部分进行类型检查 用它。

如果您不知道要接受什么类型，或者当您想接受任何东西时，因为您会盲目地传递它而不与它交互，则可以使用 unknown.

Return Types of Callbacks

不要将返回类型 any 用于其值将被忽略的回调。下列用法不推荐：

function fn(x: () => any) {

 x();

}

正确做法：使用类型 void 替代 any：

function fn(x: () => void) {

 x();

}

原因：使用 void 更安全，因为它可以防止您以未经检查的方式意外使用 x 的返回值。

function fn(x: () => void) {

 var k = x(); // oops! meant to do something else

 k.doSomething(); // error, but would be OK if the return type had been 'any'

}

Return Types of Callbacks

尽量避免在回调函数里定义 optional 参数，除非你觉得实在有必要。

interface Fetcher {

 getObject(done: (data: any, elapsedTime?: number) => void): void;

}

这有一个非常具体的含义：done 回调可能用 1 个参数调用，也可能用 2 个参数调用。 作者可能打算说回调可能不关心 elapsedTime 参数，但是没有必要使参数成为可选参数来实现这一点——提供接受更少参数的回调总是合法的。

重载和回调函数

不要编写仅在回调数量上有所不同的单独重载：

原因：

TypeScript 在解析函数调用时选择第一个匹配的重载。 当较早的重载比较晚的重载“更通用”时，较晚的重载实际上是隐藏的并且无法调用。

使用可选参数

不要写几个只在尾随参数上不同的重载：