什么是TypeScript Declare关键字?
参考答案
作用
declare 用来声明一个在运行时已经存在的值或模块的类型,让 TS 知道它的形状,但不生成任何 JS 代码(类型声明空间专用)。
主要用法
- 全局变量/函数/类(CDN 注入、
window上挂的东西)
declare const __DEV__: boolean;
declare function track(event: string, data?: Record<string, unknown>): void;
declare class LegacyWidget { constructor(el: HTMLElement); render(): void; }
- 声明模块(为无类型的 JS 库补类型,或声明非代码资源)
declare module 'legacy-lib' {
export function init(opts: { id: string }): void;
export default init;
}
declare module '*.svg' { const url: string; export default url; }
declare module '*.css';
- 全局类型扩展(模块增强)
declare global {
interface Window { __CONFIG__: { env: string } }
}
- 命名空间声明
declare namespace NodeJS { interface ProcessEnv { MY_VAR?: string } }
- 模块增强(给第三方库加字段)
declare module 'express-serve-static-core' {
interface Request { userId?: string }
}
与相似概念的区别
| 关键字 | 用途 | 生成代码 |
| --- | --- | --- |
| declare | 描述已存在的运行时值/模块 | ❌ 不生成 |
| type / interface | 定义纯类型 | ❌ 不生成 |
| let/const/var | 真正创建变量 | ✅ 生成 |
| declare module 'x' | 模块声明(ambient) | ❌ 不生成 |
| declare global | 全局增强 | ❌ 不生成 |
要点
- 通常放在
.d.ts文件里;在.ts里用declare global时必须保证文件是模块(有 import/export)。 - 发布库时用
declaration: true自动生成.d.ts,本质上就是一批declare语句。 - 本题与"TypeScript 中的 Declare 关键字有什么用"是同义题,回答口径一致,只是措辞不同。
- 忘记加
declare而直接写const x: number会真的生成变量,覆盖或冲突。