解释何时在 TypeScript 中使用“declare”关键字

在 TypeScript 中，使用 declare 关键字可以告诉编译器一个变量、函数、类或模块的类型，而不需要实际的实现代码。这在与第三方库或整合 JavaScript 代码时非常有用，因为它们没有 TypeScript 类型定义。

何时使用？

当我们在 TypeScript 中使用一个第三方 JavaScript 库时，如果该库没有 TypeScript 类型定义，那么在调用该库的函数或变量时，编译器就无法确定其类型，从而可能导致编译错误或运行时错误。在这种情况下，使用 declare 关键字可以像下面这样告诉编译器这个变量的类型：

declare var libraryVariable: any; // 可以为任何类型
declare function libraryFunction(): void;
declare class LibraryClass {
  name: string;
  constructor(name: string);
}

以上代码告诉编译器，libraryVariable 是一个任意类型的变量，libraryFunction 是一个无返回值的函数，LibraryClass 是一个类。

如何使用？

在实际使用 declare 关键字时，我们可以将其放在声明文件（.d.ts）中，如下所示：

// jquery.d.ts

declare var $: any;
declare function $(selector: string): any;
declare class JQuery {
    text(text: string): JQuery;
    click(handler: () => void): void;
}

以上代码定义了全局变量 $ 和函数 $(selector)，以及 JQuery 类的一些函数。这个声明文件可以在 TypeScript 项目中引用，从而在调用这些变量和函数时，编译器就可以根据声明文件中的类型定义进行类型检查了。

总结

在 TypeScript 中使用 declare 关键字可以告诉编译器第三方库或 JavaScript 代码的类型定义，从而避免编译错误和运行时错误。可以将声明放在一个声明文件中，以在整个项目中使用。