TypeScript 5.0发布了，带来了很多新特性。

本文是踩坑总结与实战经验，包括新特性介绍、常见坑、最佳实践、迁移指南，以及我的使用心得。

一、TypeScript 5.0新特性

1. 装饰器

第一个新特性：装饰器。

  • 标准的ECMAScript装饰器
  • 不再是实验性的
  • 不需要experimentalDecorators
  • 用法更规范
  • 是大更新

装饰器，是5.0的重头戏。

2. const类型参数

第二个新特性：const类型参数。

function fn<const T>(arg: T): T {
    return arg;
}
  • 推断为字面量类型
  • 更精确的类型
  • 不需要as const
  • 很实用

const类型参数，是小而美的特性。

3. 多配置文件extends

第三个新特性：多配置文件extends。

{
    "extends": ["./base1", "./base2"]
}
  • 支持数组
  • 可以继承多个配置
  • 更灵活
  • 方便复用

多配置继承，是工程化的好特性。

4. 所有枚举都是联合枚举

第四个新特性：所有枚举都是联合枚举。

  • 数字枚举也变成联合类型
  • 类型收窄更好
  • 更安全
  • 是内部改进

联合枚举，是类型系统的改进。

5. 速度提升

第五个新特性：速度提升。

  • 编译速度更快
  • 内存占用更少
  • 重构了内部架构
  • 从namespace改成module
  • 性能提升明显

速度，是5.0的亮点。

二、踩坑总结

1. 坑一：装饰器不兼容旧写法

第一个坑：装饰器不兼容旧写法。

  • 旧的实验性装饰器
  • 和新标准不兼容
  • 需要改写
  • 第三方库可能还没更新
  • 迁移要注意

装饰器兼容，是最大的坑。

2. 坑二：lib更新导致类型变化

第二个坑：lib更新导致类型变化。

  • DOM lib更新
  • 有些类型变了
  • 有些方法签名变了
  • 可能报错
  • 需要适配

lib更新，是常见的坑。

3. 坑三：strict模式更严格

第三个坑：strict模式更严格。

  • 5.0的检查更严格
  • 以前不报错的现在报错
  • 特别是any相关
  • 需要修复
  • 是好事但麻烦

strict更严格，是升级的痛。

4. 坑四：第三方库类型不兼容

第四个坑：第三方库类型不兼容。

  • 有些库的类型
  • 在5.0下报错
  • 需要等库更新
  • 或者自己修补
  • 是常见问题

第三方库，是升级的障碍。

5. 坑五：配置文件变化

第五个坑：配置文件变化。

  • 有些配置项废弃了
  • 有些配置项变了
  • 需要更新tsconfig
  • 注意检查
  • 不然会有警告

配置变化，是细节坑。

三、实战经验

1. 经验一：渐进式升级

第一个经验：渐进式升级。

  • 不要一下子全改
  • 先升级版本
  • 修报错
  • 再用新特性
  • 逐步迁移

渐进式，是稳妥的方式。

2. 经验二：先开strict

第二个经验：先开strict。

  • strict能发现很多问题
  • 越早开越好
  • 新代码直接strict
  • 老代码逐步迁移
  • 不要逃避

strict，是质量的保障。

3. 经验三：善用工具类型

第三个经验：善用工具类型。

  • Partial
  • Required
  • Pick
  • Omit
  • Record
  • 这些工具类型很实用

工具类型，是效率的保障。

4. 经验四：类型不要过度

第四个经验：类型不要过度。

  • 不要为了类型而类型
  • 复杂的类型不如any
  • 可读性也很重要
  • 平衡类型和简洁
  • 适度就好

适度，是智慧。

5. 经验五：类型也是文档

第五个经验：类型也是文档。

  • 好的类型就是文档
  • 看类型就知道怎么用
  • 比注释更可靠
  • 要写好类型
  • 利人利己

类型，是最好的文档。

四、最佳实践

1. 实践一：用interface还是type？

第一个实践：用interface还是type？

  • interface：适合对象，可扩展
  • type：适合联合类型、工具类型
  • 都可以
  • 团队统一就行
  • 不要纠结

interface vs type，是经典问题。

2. 实践二：any和unknown的选择

第二个实践：any和unknown的选择。

  • any：放弃类型检查
  • unknown：类型安全的any
  • 优先用unknown
  • 必要时再用any
  • 尽量少用any

unknown，是更安全的选择。

3. 实践三：泛型的使用

第三个实践：泛型的使用。

  • 泛型提高复用性
  • 但不要过度泛型
  • 简单场景不用泛型
  • 复杂场景用泛型
  • 平衡

泛型，是双刃剑。

4. 实践四：类型断言

第四个实践：类型断言。

  • as是类型断言
  • 不要滥用
  • 确认类型再断言
  • 优先用类型守卫
  • 断言是最后手段

类型断言，要谨慎。

5. 实践五：类型守卫

第五个实践：类型守卫。

  • typeof
  • instanceof
  • in
  • 自定义类型守卫
  • 比断言安全

类型守卫，是推荐的方式。

五、迁移指南

1. 第一步：升级版本

第一步：升级版本。

npm install typescript@5
  • 先升级
  • 看有什么报错
  • 不要急着改
  • 先了解情况

升级，是第一步。

2. 第二步：修复报错

第二步：修复报错。

  • 逐个修复
  • 先修简单的
  • 再修复杂的
  • 实在不行先@ts-ignore
  • 后面再改

修复，是核心步骤。

3. 第三步：更新配置

第三步：更新配置。

  • 更新tsconfig
  • 去掉废弃的配置
  • 用新的配置
  • 优化配置
  • 保持整洁

配置，要更新。

4. 第四步：用新特性

第四步：用新特性。

  • 装饰器
  • const类型参数
  • 多配置继承
  • 逐步使用
  • 不要一下子全用

新特性，慢慢用。

5. 第五步：持续优化

第五步：持续优化。

  • 类型优化
  • 性能优化
  • 代码质量
  • 持续改进
  • 没有终点

优化，是持续的。

六、常见问题

1. 问题一：报错太多怎么办？

第一个问题：报错太多怎么办？

  • 先升级
  • 分批修复
  • 可以先skipLibCheck
  • 逐步修复
  • 不要急

报错多，是正常的。

2. 问题二：第三方库类型报错怎么办？

第二个问题：第三方库类型报错怎么办？

  • 等库更新
  • 自己写d.ts
  • 用patch-package
  • 提PR
  • 临时@ts-ignore

第三方库，是常见问题。

3. 问题三：编译变慢了怎么办？

第三个问题：编译变慢了怎么办？

  • 5.0应该更快
  • 如果变慢了
  • 检查配置
  • 检查项目大小
  • 可以用增量编译

编译速度，要关注。

4. 问题四：要不要升级？

第四个问题：要不要升级？

  • 建议升级
  • 新特性好
  • 性能好
  • 但要评估成本
  • 大项目可以等等

升级，是趋势。

5. 问题五：装饰器怎么用？

第五个问题：装饰器怎么用？

  • 看官方文档
  • 看示例
  • 先简单用
  • 再深入
  • 注意和旧装饰器的区别

装饰器，要学习。

七、写在最后

TypeScript 5.0+，踩坑总结与实战经验。

新特性：装饰器、const类型参数、多配置继承、联合枚举、速度提升。踩坑：装饰器不兼容、lib更新、strict更严格、第三方库不兼容、配置变化。实战经验：渐进式升级、先开strict、善用工具类型、类型不要过度、类型也是文档。最佳实践：interface vs type、any vs unknown、泛型、类型断言、类型守卫。

2023年了，TypeScript 5.0是一个大版本，带来了很多新特性，也有一些坑。升级要渐进，修复要耐心，新特性要慢慢用。TypeScript是好工具，用好了能大大提高代码质量和开发效率。

最后，用一句话总结："TypeScript 5.0，新特性很吸引人，升级有坑但值得。渐进式升级，善用类型，持续优化，你会爱上TypeScript。"

希望我的踩坑总结和实战经验，能帮到你。