TypeScript中declare關鍵詞作用小結(jié)

更新時間：2025年08月12日 09:36:27 作者：CAD老兵

declare是一個非常重要的關鍵字,主要用于聲明變量、函數(shù)、類、模塊或命名空間的類型,下面就來介紹一下declare關鍵詞的使用,感興趣的可以了解一下

在 TypeScript 中，declare 是一個非常重要的關鍵字，主要用于聲明變量、函數(shù)、類、模塊或命名空間的類型，而不進行實際的實現(xiàn)。它通常用于告訴 TypeScript 編譯器某個標識符已經(jīng)在其他地方（比如 JavaScript 文件、全局作用域、第三方庫）被定義了，從而避免類型檢查報錯。

一、為什么需要declare？

TypeScript 是一種靜態(tài)類型語言，需要在編譯時知道所有標識符的類型信息。如果你使用了一個在 JavaScript 中定義、但 TypeScript 無法推斷其類型的變量或函數(shù)，編譯器就會報錯。此時可以使用 declare 來顯式地告訴編譯器這個標識符已經(jīng)存在于運行時環(huán)境中。

舉個例子，如果你在使用一個瀏覽器全局變量 window.myPlugin，TypeScript 默認是不知道這個變量的：

console.log(window.myPlugin); // 報錯：Property 'myPlugin' does not exist on type 'Window & typeof globalThis'.

你可以用 declare 來聲明它：

declare global {
  interface Window {
    myPlugin: any;
  }
}

或者：

declare const myPlugin: any;

這樣編譯器就不會報錯了。

二、declare的使用場景

1. 聲明全局變量

declare const VERSION: string;
console.log(VERSION);

這告訴 TypeScript：VERSION 是在其他地方定義的（比如通過 <script> 標簽引入的腳本），類型是 string。

2. 聲明函數(shù)

declare function greet(name: string): void;

表示 greet 是一個已經(jīng)存在的函數(shù)，不需要在當前文件中實現(xiàn)它。

3. 聲明類

declare class Animal {
  name: string;
  constructor(name: string);
  speak(): void;
}

這個類可能是在其他 JavaScript 文件或第三方庫中定義的。

4. 聲明模塊

declare module 'my-library' {
  export function doSomething(): void;
}

適用于沒有類型聲明文件（.d.ts）的第三方庫。

5. 聲明命名空間

declare namespace MyLib {
  function func(): void;
}

適用于一些老的、通過全局對象暴露 API 的庫。

三、.d.ts文件中的declare

在 TypeScript 的類型聲明文件（通常以 .d.ts 結(jié)尾）中，declare 是主角。所有的聲明都不會編譯成 JavaScript，而是僅用于類型檢查和代碼提示。

比如：

// my-types.d.ts
declare const myGlobal: number;
declare function myFunc(): void;
declare module 'some-lib' {
  export function hello(): string;
}

當你安裝一個第三方 JavaScript 庫時，如果沒有內(nèi)置類型定義，可以手動編寫 .d.ts 文件進行補充。

四、不使用declare會怎樣？

如果你在沒有類型聲明的情況下使用未定義的標識符，TypeScript 會報錯。例如：

console.log(EXTERNAL_VAR); // 錯誤：Cannot find name 'EXTERNAL_VAR'

使用 declare 后：

declare const EXTERNAL_VAR: string;
console.log(EXTERNAL_VAR); // 正確

五、總結(jié)

用法	示例	說明
聲明變量	declare const foo: number;	告訴 TS 有一個外部變量 foo
聲明函數(shù)	declare function bar(): void;	聲明外部函數(shù)，無需實現(xiàn)
聲明類	declare class Person {}	聲明外部類
聲明模塊	declare module 'lib' {}	用于第三方庫的類型聲明
聲明全局接口	declare global {}	擴展全局作用域，如 Window 接口等