← 返回完整题库
Typescript中等

什么是TypeScript Declare关键字?

参考答案

作用

declare 用来声明一个在运行时已经存在的值或模块的类型,让 TS 知道它的形状,但不生成任何 JS 代码(类型声明空间专用)。

主要用法

  1. 全局变量/函数/类(CDN 注入、window 上挂的东西)
declare const __DEV__: boolean;
declare function track(event: string, data?: Record<string, unknown>): void;
declare class LegacyWidget { constructor(el: HTMLElement); render(): void; }
  1. 声明模块(为无类型的 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';
  1. 全局类型扩展(模块增强)
declare global {
  interface Window { __CONFIG__: { env: string } }
}
  1. 命名空间声明
declare namespace NodeJS { interface ProcessEnv { MY_VAR?: string } }
  1. 模块增强(给第三方库加字段)
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 会真的生成变量,覆盖或冲突。

本题来自 计算机知识面试题库,共 921 道题。