TS

tsconfig.json 生成

预设一键生成,选项冲突当场报出来

改预设会覆盖上面的选项,之后可以再手动微调。


                
                

如何使用本工具

  1. 先选一个项目预设,工具会把 target、module、moduleResolution 等关键项一次填好。
  2. 按实际项目微调:输出目录、rootDir、types、以及 strict / declaration 等开关。
  3. 右侧实时生成 tsconfig.json,下面的「配置检查」会列出选项之间的冲突与提醒。
  4. 红色「冲突」必须修,橙色「提醒」按项目情况判断,绿色表示没有明显问题。
  5. 点复制或下载,把文件放到项目根目录即可。

常见问题

Q:moduleResolution: bundler 为什么要求 module 是 ESNext?

A:bundler 是给 Vite、Webpack、esbuild 这类打包器用的解析模式,它模拟打包器的 ESM 解析行为,允许 import 不带扩展名、支持 package.json 的 exports 字段。TypeScript 规定它只能和 module: esnext(或 5.4+ 的 preserve)搭配,配成 commonjs 或 node16 会直接报错 TS5095。老项目如果用 CommonJS,就退回 moduleResolution: node10 或 node16。

Q:Node16 / NodeNext 为什么 module 和 moduleResolution 要同名?

A:因为 Node.js 从 12 起同时支持 CJS 和 ESM,TypeScript 要根据文件后缀和最近的 package.json 的 type 字段决定每个文件是 CJS 还是 ESM。这套判断逻辑绑定在 module: node16 / nodenext 上,所以 moduleResolution 也必须用同名值,不能只改一半。

Q:noEmit 和 declaration 一起开会生成 .d.ts 吗?

A:不会。noEmit 会关掉所有产出,包括声明文件。想只生成声明文件用 emitDeclarationOnly: true,并配合 declaration: true;这两个才是专门给「类型由打包器生成、tsc 只出类型」场景用的。

Q:esModuleInterop 是干什么的,一定要开吗?

A:它让 import fs from 'fs' 这类默认导入能正确拿到 CommonJS 模块的 module.exports,同时会顺带打开 allowSyntheticDefaultImports。新项目建议开;如果项目全是 ESM 且依赖也都提供正确的 ESM 入口,可以不开,但混用 CJS 依赖时不开很容易踩到 undefined。

Q:skipLibCheck 可以随便开吗?

A:它跳过 node_modules 里 .d.ts 的类型检查,能显著加快编译、避开第三方库之间的类型冲突,代价是第三方声明里的错误不会被发现。绝大多数项目都开,只有你在给库做严格类型审计时才建议关掉。

Q:lib 里要不要写 DOM?

A:浏览器项目要写 DOM、DOM.Iterable;Node.js 后端别写,否则代码里误用 window、document 编译器也不会拦你。写了 React 的 jsx 却没写 DOM 是常见疏漏,工具会在检查里提醒。