TypeScript-ESLint项目中no-deprecated规则对导入变量的检测问题分析

问题背景

在TypeScript-ESLint项目中，no-deprecated规则用于检测代码中使用了已被标记为不建议使用的变量或方法。然而，近期发现该规则存在一个特定场景下的检测问题：当被不建议使用的变量是通过导入方式引入，并且被直接用于对象属性赋值时，规则无法正确识别并报告这种不建议使用情况。

问题现象

通过对比测试发现以下现象：

1. 本地不建议使用变量：当不建议使用变量在同一个文件中定义时，规则能够正确报告不建议使用

/** @deprecated 不建议使用原因说明 */
const localDeprecated = 'value';

const obj = {
  prop: localDeprecated // 正确触发不建议使用警告
};

2. 导入不建议使用变量：当不建议使用变量从其他模块导入时，规则失效

import { importedDeprecated } from './module';

const obj = {
  prop: importedDeprecated // 未触发不建议使用警告
};

3. 中间变量使用：有趣的是，如果通过中间变量使用导入的不建议使用变量，规则又能正常工作

import { importedDeprecated } from './module';

const temp = importedDeprecated;
const obj = {
  prop: temp // 正确触发不建议使用警告
};

技术分析

深入分析no-deprecated规则的实现逻辑，发现问题出在符号(Symbol)处理环节：

1. 符号链追踪不足：当处理导入变量时，规则没有充分追踪符号的别名链。TypeScript中，导入的变量实际上是原始导出变量的别名，而不建议使用标记可能存在于原始符号上。

2. 属性赋值场景的特殊性：在对象属性赋值场景下，规则对导入变量的符号处理存在缺陷，未能正确应用searchForDeprecationInAliasesChain方法来遍历符号链查找不建议使用标记。

3. 类型检查差异：值得注意的是，TypeScript自身的类型检查器(tsc)能够正确识别这种不建议使用情况(通过错误代码ts(6385))，说明这是ESLint规则实现层面的问题，而非TypeScript核心功能的问题。

影响范围

这个问题特别影响以下场景的开发：

• Angular模块配置中使用不建议使用的注入令牌
• 大型项目中跨模块使用的不建议使用API
• 通过对象字面量进行配置的框架代码

解决方案建议

针对这个问题，建议从以下几个方面进行修复：

1. 增强符号链追踪：在处理属性赋值场景时，应当始终对变量符号应用完整的别名链检查。

2. 统一处理逻辑：将导入变量和本地变量的处理逻辑统一，确保一致的不建议使用检测行为。

3. 添加特殊场景测试：补充针对对象属性赋值场景的测试用例，特别是跨模块使用的情况。

总结

TypeScript-ESLint的no-deprecated规则在大多数情况下工作良好，但在处理导入变量用于对象属性赋值这一特定场景时存在检测问题。这个问题源于规则实现中对符号链追踪的不完整性，特别是在跨模块符号引用场景下的处理不足。对于依赖ESLint进行不建议使用API检测的团队，建议关注此问题的修复进展，同时在过渡期可以结合TypeScript自身的不建议使用检测功能进行补充验证。