用途:面向真实 TypeScript 6+ 项目的日常开发、配置、调试与升级排障,帮助减少升级调查时间与常见 tsconfig 回归。
主要能力:给出编译器配置与模块解析的明确建议;梳理 TS 6 弃用项与替代方案;说明新标准库类型(如 RegExp.escape、getOrInsert、Temporal)与运行时支持的区别;提供验证与诊断流程;列出常见问题及预防方式。
必要用法:先让关键选项显式化,典型配置包含 "rootDir": "./src"、"outDir": "./dist"、"types": ["node"]、"strict": true。模块解析需刻意选择:打包应用通常用 "module": "esnext" 配 "moduleResolution": "bundler",现代 Node.js 包通常用 "module": "nodenext"、"moduleResolution": "nodenext"。改代码前先用 npx tsc --noEmit、npx tsc --showConfig、npx tsc --explainFiles 验证配置与文件图,必要时用 npx tsc --traceResolution 排查解析问题。
适用场景:升级到 TS 6 的迁移、路径别名从 baseUrl 迁移到 paths、monorepo 与 project references、Node 与打包应用的配置选择、侧效应导入与全局类型缺失排障。
限制与注意:不要把 ignoreDeprecations: "6.0" 当长期方案;--stableTypeOrdering 仅用于 TS 6 与 TS 7 对比或排序问题排查,不适合作为常规构建标志;类型存在不代表运行时可用,需单独验证运行时兼容与 polyfill;部分具体价格、平台等信息暂未提供。