TypeScript ESLint插件中no-deprecated规则对accessor属性的误报问题分析

在TypeScript 5.3及以上版本中，accessor属性作为一种新的类成员声明方式被引入。然而，当开发者在使用TypeScript ESLint插件的no-deprecated规则时，可能会遇到一个特殊问题：该规则会错误地将带有@deprecated标记的accessor属性声明本身也标记为已弃用，而实际上它应该只标记这些属性的使用。

问题本质

accessor属性是TypeScript提供的一种语法糖，它允许开发者简洁地定义getter和setter。当accessor属性被标记为@deprecated时，合理的预期是：

1. 该属性的使用（如实例访问）应该被no-deprecated规则标记
2. 但属性声明本身不应被视为已弃用

当前实现的问题在于，no-deprecated规则没有正确区分accessor属性的声明和使用场景，导致对声明也进行了不必要的警告。

技术背景

在TypeScript中，accessor属性的编译结果实际上会被转换为标准的getter和setter。例如：

class T {
  @deprecated
  accessor foo = "bar";
}

会被编译为：

class T {
  #foo_accessor_storage = "bar";
  get foo() { return this.#foo_accessor_storage; }
  set foo(value) { this.#foo_accessor_storage = value; }
}

no-deprecated规则需要能够识别这种转换后的结构，并正确处理其中的弃用标记。

影响范围

这个问题会影响以下使用场景：

1. 使用accessor属性声明并标记为@deprecated的类
2. 配置了@typescript-eslint/no-deprecated规则的ESLint环境
3. TypeScript 5.3及以上版本项目

解决方案建议

要正确实现这一功能，no-deprecated规则需要：

1. 识别accessor属性声明节点
2. 区分声明节点和使用节点
3. 对于声明节点，跳过弃用检查
4. 对于使用节点（如属性访问），正常进行弃用检查

在AST层面，这需要正确处理PropertyDeclaration节点及其装饰器，同时识别accessor修饰符的存在。

临时解决方案

在官方修复发布前，开发者可以通过以下方式临时解决：

1. 对accessor属性声明禁用行级检查
2. 使用标准的getter/setter替代accessor语法
3. 暂时禁用no-deprecated规则

总结

TypeScript ESLint插件的no-deprecated规则对accessor属性的处理存在改进空间。理解这一问题的本质有助于开发者更好地使用TypeScript的新特性，同时保持代码质量检查的有效性。随着TypeScript新特性的不断引入，相关的lint规则也需要相应更新以保持同步。