tsconfig.json 生成与检查

选择项目类型并勾选选项,生成带中文注释的 tsconfig.json;也可以粘贴已有的配置,逐项解释作用,并按 TypeScript 6.0 和 7.0 的变化找出已弃用、已移除或互相冲突的选项。

目标与模块
类型检查
输出

    TypeScript 6.0 和 7.0 带来的变化

    • TypeScript 7.0(2026 年 7 月):编译器用 Go 重写为原生程序,命令仍是 tsc,类型检查速度约快 10 倍,语言本身不变。TypeScript 6.0 中弃用的选项在 7.0 中直接报错。
    • 新的默认值(6.0 起):strict 默认为 true,module 默认 esnext,target 默认最新的 ECMAScript 版本,types 默认为空数组(不再自动加载 node_modules/@types 下的所有包,需要的写进 types,如 ["node"]),rootDir 默认为 tsconfig 所在目录。为了在不同版本间行为一致,建议在配置中显式写出这些选项。
    • 已移除的写法:target ES5、downlevelIteration、moduleResolution node(node10)和 classic、module 的 amd / umd / system、baseUrl、outFile,以及把 esModuleInterop、allowSyntheticDefaultImports、alwaysStrict 设为 false。临时兼容可以写 "ignoreDeprecations": "6.0",但升级到 7.0 前必须改掉。
    • baseUrl 怎么改:paths 从 TypeScript 4.1 起就不依赖 baseUrl,直接写相对于 tsconfig 的路径即可,例如 "@/*": ["./src/*"]。
    • moduleResolution 选哪个:用 Vite、webpack、esbuild 等打包工具的项目选 bundler;直接用 Node.js 运行的代码和 npm 库选 NodeNext(导入相对文件时要写 .js 扩展名)。
    • Node.js 直接运行 TypeScript:Node.js 22.18 / 24 起默认可以直接运行 .ts 文件(去掉类型注解后执行),但不支持 enum、namespace 等需要编译的语法,可以开启 erasableSyntaxOnly 提前发现。

    生成 package.json 请用 package.json 生成器,把 JSON 数据转成 TypeScript 类型请用 JSON 转 TypeScript。

    tsconfig.json 生成与检查常见问题

    tsconfig.json 生成与检查怎么使用?

    在“生成配置”中选择预设(Vite 前端、Node.js、npm 库、Next.js、Monorepo),再调整目标、模块、lib、类型检查和输出选项,下方生成带中文注释的 tsconfig.json;在“检查已有配置”中粘贴现有的 tsconfig,逐项查看作用和问题。

    moduleResolution 选 bundler 还是 NodeNext?

    用 Vite、webpack 等打包工具选 bundler,直接用 Node.js 运行或发布 npm 包选 NodeNext。

    TypeScript 7 移除了哪些选项?

    target ES5、moduleResolution node 和 classic、baseUrl、outFile、downlevelIteration 等。

    去掉 baseUrl 后 paths 怎么写?

    写相对于 tsconfig 的路径,例如 "@/*": ["./src/*"]。

    为什么升级后找不到 node 的类型?

    TypeScript 6.0 起 types 默认为空,需要在 types 中加入 "node"。

    tsconfig.json 生成与检查的结果应怎样理解?

    只检查 compilerOptions 中的常用选项和 TypeScript 6.0、7.0 的弃用项,不解析 extends 引用的配置;带注释的配置只在 tsconfig 中有效,其他 JSON 解析器可能不认。

    输入内容会保存或发给外部服务吗?

    配置只在浏览器本地生成和检查,不会上传。

    没有结果或操作失败时先检查什么?

    升级 TypeScript 后出现弃用错误时,在“检查已有配置”中粘贴配置,按标红的提示逐项修改;临时可以加 "ignoreDeprecations": "6.0"。

    相关工具

    JSON Schema 生成器 · JSON 格式化校验 · Base64 编码解码 · URL 编码解码 · 全部开发工具