TypeScript ESLint 规则优化：建议用 PropertyKey 替代 keyof any

在 TypeScript 开发中，keyof any 是一个常见但可能令人困惑的类型表达式。typescript-eslint 项目中的 no-explicit-any 规则最近提出了一个增强建议：当检测到 keyof any 时，建议开发者使用更明确的 PropertyKey 类型。

背景知识

在 TypeScript 类型系统中，keyof any 表示可以作为对象键的类型，其实际类型是 string | number | symbol 的联合类型。TypeScript 提供了一个内置的实用类型 PropertyKey 来精确表示这个概念。

问题现状

当前，许多开发者可能直接从其他代码中复制了 keyof any 的用法，但并不完全理解其含义。这会导致：

1. 代码可读性降低
2. 新手开发者困惑
3. 类型表达不够直观

解决方案

typescript-eslint 的 no-explicit-any 规则计划增加一个检查，当发现 keyof any 时：

1. 报告为可修复的问题
2. 建议使用 PropertyKey 替代
3. 提供自动修复功能

代码示例对比

改进前代码

const integer = <TKey extends keyof any, TTarget extends { [K in TKey]: number }>(
  target: TTarget,
  key: TKey
) => { /* ... */ };

改进后代码

const integer = <TKey extends PropertyKey, TTarget extends { [K in TKey]: number }>(
  target: TTarget,
  key: TKey
) => { /* ... */ };

技术优势

1. 语义更明确：PropertyKey 直接表达了"可作为属性键的类型"的意图
2. 一致性更好：使用标准库提供的类型而非语言特性
3. 可维护性：减少了对 TypeScript 特定语法的依赖
4. 工具支持：IDE 对内置类型的支持通常更好

实现考虑

这个改进可以作为一个可选规则加入，因为：

1. 不影响现有代码行为
2. 完全向后兼容
3. 可以通过自动修复无痛升级
4. 对性能无影响

总结

这个改进虽然看似微小，但对于提升 TypeScript 代码的质量和可读性有着重要意义。它体现了 TypeScript 社区对代码清晰性和一致性的持续追求，也是 typescript-eslint 工具不断完善的一个例证。