@typescript-eslint/no-shadow误报当前声明变量遮蔽问题咨询

1. 内部同名变量的实用场景 #

这种参数遮蔽外层变量的写法并非没有实用价值，反而在很多场景下能提升代码可读性：

• 当回调函数不需要访问外层同名变量时，用同名参数可以直观表达当前处理的对象类型。比如遍历同类型数组时：

  const currentUser = getCurrentUser();
  const userList = allUsers.map((user) => ({
    id: user.id,
    displayName: `${user.firstName} ${user.lastName}`
  }));
  

  这里用user作为参数名，能清晰表明回调处理的是单个用户对象，无需额外构思诸如u、tempUser这类冗余命名。
• 刻意利用遮蔽避免意外修改外层变量：如果外层变量是需要保护的引用，用同名参数可以确保回调内的操作不会误触外层变量。

2. 规则的解决方案（无需新增规则） #

@typescript-eslint/no-shadow本身提供了配置选项来规避这种场景的报错，不需要新增规则。你可以在ESLint配置中添加allow参数，允许函数参数遮蔽外层变量：

{
  "rules": {
    "@typescript-eslint/no-shadow": [
      "error",
      {
        "allow": ["parameters"]
      }
    ]
  }
}

这个配置会放行所有函数参数对外层变量的遮蔽，刚好匹配你遇到的find回调场景。如果需要更精细的控制，还可以通过ignoreFunctionTypeParameterNameValueShadow等子选项进一步调整，但allow: ["parameters"]已经能覆盖绝大多数常见需求。

内容的提问来源于stack exchange，提问作者Florian Lentsch