SuperAPI AI 工具集

ts-config

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在创建或迁移 tsconfig.json、选择 module 与 moduleResolution、以及清理 TS 6.0 弃用项(TS 7.0 原生 Go 编译器将其视为硬错误)时使用。不覆盖 TypeScript 语言语法与惯用法,也不覆盖自带 tsconfig 基座的框架配置(Next.js/Astro/Vite 插件)及非 TS 构建工具。

主要能力:给出 2026 年两条受支持配置路线,按运行时选择且不可混用。Bundler 路线(Bun、Vite、esbuild、webpack)使用 module: Preserve 与 moduleResolution: bundler;Node 路线(纯 Node.js 原生类型剥离)使用 module: nodenext 与 moduleResolution: nodenext。关键规则:禁用 moduleResolution: node/node10(6.0 弃用、7.0 硬错误);两条路线均设 verbatimModuleSyntax: true;strict 自 6.0 起为默认,需显式加 noUncheckedIndexedAccess;显式设置 types(默认已变为 []);源码嵌套时显式设置 rootDir(不再自动推断)。

使用方式:写配置前并行启动三个 agent,分别探测运行时与现有配置、核对官方发布说明与运行时文档、查询 /microsoft/typescript 文档;写完后运行验证。迁移 5.x 配置或遇到弃用错误时先处理 deprecations-6.md,再选路线。参考文档含 bundler-track.md、node-track.md、deprecations-6.md 及两份模板。

限制与注意:不要混用 module: Preserve 与 moduleResolution: nodenext;不要将 esModuleInterop、allowSyntheticDefaultImports、alwaysStrict 设为 false;Node 类型剥离运行的文件中避免 enum、带运行时代码的 namespace 与参数属性。迁移期可临时加 "ignoreDeprecations": "6.0",TS 7.0 不再支持。需要编译器 API 的工具(如 typescript-eslint)可经 @typescript/typescript6 别名留在 TS 6。baseUrl 已弃用,应折入各 paths 条目。具体版本行为与命令细节以官方资料为准,本资料未提供完整安装命令。