TypeScript Changelog

版本历史

TypeScript 6.0

发布日期: 2025年3月23日 (v6.0.2 稳定版)

官方来源:

• Announcing TypeScript 6.0 - Microsoft 官方发布说明
• GitHub Releases - TypeScript 6.0.2 稳定版

版本定位: TypeScript 6.x 是最后一个基于 JavaScript 实现的版本，作为过渡到 TypeScript 7.0（基于 Go 的原生实现）的桥梁。

Breaking Change: types 默认改为

来源验证:

"types now defaults to . TypeScript will no longer pull in potentially thousands of type declarations at build time. Great for performance, but... if you were relying on it, your project will break!" — Microsoft TypeScript 6.0 Announcement

技术背景:

• 此前 TypeScript 会自动加载 node_modules/@types 下的所有类型声明
• 这导致大型项目构建时可能需要处理数千个类型声明文件
• 新默认值显著提升构建性能，但要求开发者显式声明所需类型

Breaking Change: strict 默认改为 true

来源验证:

"strict is now true by default. Many of you will already be working in strict mode, but if not, get ready for a flood of new type errors unless you explicitly set it to false." — Microsoft TypeScript 6.0 Announcement

技术背景:

• strict: true 启用所有严格类型检查选项，包括：
  • noImplicitAny: 禁止隐式 any 类型
  • strictNullChecks: 严格的 null 检查
  • strictFunctionTypes: 严格的函数类型检查
  • strictBindCallApply: 严格的 bind/call/apply 检查
  • strictPropertyInitialization: 严格的属性初始化检查
  • noImplicitThis: 禁止隐式 this 类型
  • alwaysStrict: 始终使用严格模式

Breaking Change: moduleResolution node 已弃用

来源验证:

"--moduleResolution node is deprecated. If you're targeting Node, you' ll now use --moduleResolution nodenext which reflects how modern versions of Node resolve modules." — Microsoft TypeScript 6.0 Announcement

详细变更:

• moduleResolution: node10（原 node）现已弃用
• 对于 Node.js 项目，应使用 nodenext
• 对于打包工具项目，应使用 bundler
• 可添加 "ignoreDeprecations": "6.0" 临时忽略弃用警告

Breaking Change: module 默认改为 esnext

来源验证:

"module now defaults to esnext. CommonJS projects must now set 'module': 'commonjs' explicitly." — Microsoft TypeScript 6.0 Announcement

相关弃用:

• module: amd / umd / systemjs / none 均已弃用
• ESM 现已成为通用标准

Feature: 子路径导入 (Subpath Imports) 支持

来源验证:

"#/ subpath imports now work. Available in Node since v25.4 (and backported into LTS releases), but now in TypeScript too." — Microsoft TypeScript 6.0 Announcement

配置示例:

// package.json
{
  "imports": {
    "#*": "./src/*",
    "#utils/*": "./src/utils/*"
  }
}

// 使用子路径导入
import { helper } from '#/utils/helper';

Breaking Change: rootDir 默认改为 .

来源验证:

"rootDir now defaults to . If you have source files deeper than your tsconfig. json and were relying on TypeScript to infer a common root directory, you now need to explicitly set rootDir." — Microsoft TypeScript 6.0 Announcement

Breaking Change: esModuleInterop 和 allowSyntheticDefaultImports 限制

来源验证:

"--esModuleInterop false and --allowSyntheticDefaultImports false no longer work. So if you' re still using syntax like import * as express from 'express' it won't work, you'd need to use import express from ' express'." — Microsoft TypeScript 6.0 Announcement

代码迁移示例:

// 旧语法（不再支持）
import * as express from "express";

// 新语法（推荐）
import express from "express";

其他默认配置变更

已弃用选项（将于 7.0 移除）

临时缓解措施:

{
  "compilerOptions": {
    "ignoreDeprecations": "6.0"
  }
}

注意：TypeScript 7.0 将不支持任何已弃用的选项。

命令行行为变更

变更: 当 tsconfig.json 存在时，指定命令行文件路径现在会报错。

迁移方案: 使用 --ignoreConfig 覆盖此行为。

迁移建议

根据 Microsoft 官方建议，升级 TypeScript 6.0 时，大多数项目需要至少进行以下一项调整：

1. 设置类型声明:

   {
     "compilerOptions": {
       "types": ["node"]
     }
   }
   

   
   或使用 "types": ["*"] 恢复旧行为。
2. 设置根目录（如果依赖之前的自动推断）:

   {
     "compilerOptions": {
       "rootDir": "./src"
     }
   }
   

3. 临时忽略弃用警告（不推荐长期使用）:

   {
     "compilerOptions": {
       "ignoreDeprecations": "6.0"
     }
   }
   

版本演进路线图

参考资料

• TypeScript 6.0 Release Notes
• TypeScript GitHub Releases
• TypeScript Compiler Options
• TypeScript Roadmap