SuperAPI AI 工具集

typescript

编程与开发

查看项目

更新于 10-21 13:20

技能介绍

用途

TypeScript 技能面向需要配置、类型检查或迁移 TypeScript 项目的开发者。它基于 TypeScript 7.0(2026 年 7 月发布的编译器原生移植版:同一 tsc 命令,完整构建通常快 8–12 倍,暂无编程 API),并说明 6.0 引入的默认值已不同于 5.x,因此从旧项目复制的 tsconfig.json 常常会失败。技能覆盖按目标选择设置、在 CI 中类型检查、直接运行 .ts 文件、保持类型真实的模式,以及从 JavaScript 迁移。

主要能力

  • 按代码运行方式选择 tsconfig.json 设置:Node.js 服务(tsc 编译后从 dist/ 运行)、由打包器构建的 Web 应用(打包器输出、tsc 只检查)、发布到 npm 的库(tsc 输出 JavaScript 和声明文件)。
  • 说明编译器版本差异:先运行 npx tsc --version,因为默认值取决于版本。列出 5.9 及更早与 6.0/7.0 的默认值对照(strict、types、rootDir、module、target、noUncheckedSideEffectImports)。
  • 列出 6.0 弃用(TS5101/TS5107,可用 "ignoreDeprecations": "6.0" 静默)与 7.0 移除(TS5102/TS5108,无法静默)的选项。
  • 说明 strict 覆盖哪些标志,以及需要单独添加的标志(noUncheckedIndexedAccess、exactOptionalPropertyTypes、noImplicitOverride、noFallthroughCasesInSwitch)。
  • CI 类型检查命令:npx tsc --noEmit、npx tsc -b、npx tsc --noEmit --checkers 2(仅 7.0)。
  • 用项目引用拆分 monorepo,包括根 tsconfig.json 与共享 tsconfig.base.json 示例。
  • 无构建步骤运行 TypeScript:npx tsx、node 内置类型剥离及其限制。
  • 保持类型真实的模式:可辨识联合与 never 穷尽检查、satisfies、在边界用 unknown 加验证。
  • 常见编译器错误修复表(TS2591、TS5011、TS2835、TS1484、TS7016、TS18048、TS2375、TS18046、TS1294)。
  • JavaScript 代码库迁移步骤。

使用方式

技能以配置示例和命令形式给出。例如 Node.js 服务配置使用 module: nodenext、target: es2023、lib: ["es2023"]、types: ["node"]、rootDir: ./src、outDir: ./dist、strict: true 等;Web 应用配置使用 module: preserve、noEmit: true、allowImportingTsExtensions: true 等;库配置使用 module: node18、declaration: true、isolatedDeclarations: true 等,并给出配套 package.json 的 exports 写法。CI 中运行 npx tsc --noEmit 或 npx tsc -b。无构建步骤时可用 npx tsx src/server.ts 或 node src/report.ts。

适用场景

  • 为 Node.js 服务、npm 库或打包的 Web 应用建立或修复 TypeScript 配置。
  • 从 TypeScript 5.9 升级到 7.0 后修复配置错误。
  • 在 CI 中让类型错误导致构建失败。
  • 用项目引用拆分 monorepo。
  • 直接运行 .ts 文件而不构建。
  • 从 JavaScript 代码库逐步迁移到 TypeScript。

限制

  • TypeScript 7.0 暂无编程 API(预计 7.1 添加新的 API)。typescript-eslint 以及 Vue、Svelte、Astro、MDX 工具链需要 6.0。
  • tsc 从不重写输出 JavaScript 中的 paths 别名;使用普通 tsc 输出时,@lib/money 在 Node.js 运行时会失败,需使用 package.json "imports" 或打包器。
  • Node.js 类型剥离忽略 tsconfig.json,因此 paths 别名会失败;需要代码生成的语法(enum、参数属性、含运行时代码的 namespace、import x = require())会抛出 ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX;Node.js 26 移除了 --experimental-transform-types;导入需要真实扩展名,类型导入需要 type 关键字;.tsx 文件和 node_modules 下的文件会被拒绝。
  • tsc 即使报告错误也会写出输出,除非设置 noEmitOnError;tsc -b 从不写出。
  • 从 6.0 起,在 tsconfig.json 旁运行 tsc src/invoice.ts 会报 TS5112;传入文件名的 pre-commit 钩子必须检查整个项目;--ignoreConfig 会丢弃所有项目设置。
  • 7.0 中 JSDoc 检查更严格:@enum、Closure 风格 function(string): void 和后缀 ! 不再被识别。
  • 资料未提供该技能本身的收费、价格、平台或效果信息。