no-unsafe-member-access

Disallow member access on a value with type any.

✅

在 ESLint 配置中扩展"plugin:@typescript-eslint/recommended-type-checked" 可启用此规则。

💭

该规则需要类型信息才能运行，但这会带来性能方面的权衡。

TypeScript 中的 any 类型是来自类型系统的危险 "应急方案"。使用 any 会禁用许多类型检查规则，通常最好只作为最后的手段或在原型代码时使用。

¥The any type in TypeScript is a dangerous "escape hatch" from the type system. Using any disables many type checking rules and is generally best used only as a last resort or when prototyping code.

尽管你有最好的意图，但 any 类型有时会泄漏到你的代码库中。访问 any 类型值的成员会在你的代码库中产生潜在的类型安全漏洞和错误源。

¥Despite your best intentions, the any type can sometimes leak into your codebase. Accessing a member of an any-typed value creates a potential type safety hole and source of bugs in your codebase.

此规则不允许对任何类型为 any 的变量进行成员访问。

¥This rule disallows member access on any variable that is typed as any.

Flat Config
Legacy Config

eslint.config.mjs
export default tseslint.config({
  rules: {
    "@typescript-eslint/no-unsafe-member-access": "error"
  }
});

.eslintrc.cjs
module.exports = {
  "rules": {
    "@typescript-eslint/no-unsafe-member-access": "error"
  }
};

在线运行试试这个规则 ↗

示例

¥Examples

❌ Incorrect
✅ Correct

declare const anyVar: any;
declare const nestedAny: { prop: any };

anyVar.a;
anyVar.a.b;
anyVar['a'];
anyVar['a']['b'];

nestedAny.prop.a;
nestedAny.prop['a'];

const key = 'a';
nestedAny.prop[key];

// Using an any to access a member is unsafe
const arr = [1, 2, 3];
arr[anyVar];
nestedAny[anyVar];
Open in Playground

declare const properlyTyped: { prop: { a: string } };

properlyTyped.prop.a;
properlyTyped.prop['a'];

const key = 'a';
properlyTyped.prop[key];

const arr = [1, 2, 3];
arr[1];
let idx = 1;
arr[idx];
arr[idx++];
Open in Playground

选项

该规则不可配置。

何时不使用它

¥When Not To Use It

如果你的代码库有许多现有的 any 或不安全代码区域，则可能很难启用此规则。在项目不安全区域中增加类型安全性时，跳过 no-unsafe-* 规则可能会更容易。你可以考虑在这些特定情况下使用 ESLint 禁用注释，而不是完全禁用此规则。

¥If your codebase has many existing anys or areas of unsafe code, it may be difficult to enable this rule. It may be easier to skip the no-unsafe-* rules pending increasing type safety in unsafe areas of your project. You might consider using ESLint disable comments for those specific situations instead of completely disabling this rule.

示例​

选项​

何时不使用它​

相关​

示例

选项

何时不使用它

相关