与 JavaScript 的互操作 #

TypeScript 可以无缝与 JavaScript 代码互操作，通过类型声明文件桥接类型系统。

基本概念 #

TypeScript 编译为 JavaScript，支持渐进式迁移。使用 allowJs 和 checkJs 选项处理 .js 文件。

使用场景 #

• 在 TypeScript 项目中引入现有 JavaScript 模块。
• 逐步将 JavaScript 文件转换为 TypeScript。
• 处理无类型第三方库。

示例代码 #

在 tsconfig.json 中：

{
  "compilerOptions": {
    "allowJs": true,
    "checkJs": true
  }
}

导入 JS 模块：

import * as myModule from './myJsModule';

最佳实践 #

• 为 JS 文件添加 .d.ts 声明以提供类型。
• 使用 JSDoc 注解在 JS 中添加类型信息。
• 避免混合使用时类型不匹配的问题。