Eslint参考手册
规则 | Rules
no-useless-rename
在--fix
命令行上的选项可以自动修复一些被这条规则反映的问题。
ES2015允许重命名导入和导出语句中的引用以及解构赋值。这为程序员提供了一个简洁的语法,用于在重命名这些引用时执行这些操作:
import { foo as bar } from "baz";
export { foo as bar };
let { foo: bar } = baz;
使用这种语法,可以将引用重命名为相同的名称。这是一个完全冗余的操作,因为这与完全不重命名相同。例如,这个:
import { foo as foo } from "bar";
export { foo as foo };
let { foo: foo } = bar;
是相同的:
import { foo } from "bar";
export { foo };
let { foo } = bar;
规则细节
此规则不允许将导入、导出和解构分配重命名为相同的名称。
选项
此规则允许使用以下选项进行更细粒度的控制:
-
ignoreImport
:设置为时true
,此规则不检查导入
-
ignoreExport
:设置为时true
,此规则不检查导出
-
ignoreDestructuring
:设置为时true
,此规则不检查解构分配
默认情况下,所有选项都设置为false
:
"no-useless-rename": ["error", {
"ignoreDestructuring": false,
"ignoreImport": false,
"ignoreExport": false
}]
默认情况下此规则的代码不正确的示例:
/*eslint no-useless-rename: "error"*/
import { foo as foo } from "bar";
export { foo as foo };
export { foo as foo } from "bar";
let { foo: foo } = bar;
let { 'foo': foo } = bar;
function foo({ bar: bar }) {}
({ foo: foo }) => {}
默认情况下此规则的正确代码示例:
/*eslint no-useless-rename: "error"*/
import * as foo from "foo";
import { foo } from "bar";
import { foo as bar } from "baz";
export { foo };
export { foo as bar };
export { foo as bar } from "foo";
let { foo } = bar;
let { foo: bar } = baz;
let { [foo]: foo } = bar;
function foo({ bar }) {}
function foo({ bar: baz }) {}
({ foo }) => {}
({ foo: bar }) => {}
此规则的正确代码示例{ ignoreImport: true }
:
/*eslint no-useless-rename: ["error", { ignoreImport: true }]*/
import { foo as foo } from "bar";
此规则的正确代码示例{ ignoreExport: true }
:
/*eslint no-useless-rename: ["error", { ignoreExport: true }]*/
export { foo as foo };
export { foo as foo } from "bar";
此规则的正确代码示例{ ignoreDestructuring: true }
:
/*eslint no-useless-rename: ["error", { ignoreDestructuring: true }]*/
let { foo: foo } = bar;
function foo({ bar: bar }) {}
({ foo: foo }) => {}
何时不使用它
如果您不关心冗余重命名导入、导出和解构赋值,则可以安全地禁用此规则。
兼容性
- JSCS:disallowIdenticalDestructuringNames版本此规则在 ESLint 2.11.0.Resources中引入
- 规则资源
- 文档资源
规则 | Rules相关

ESLint 是一个代码规范和错误检查工具,有以下几个特性。所有东西都是可以插拔的。你可以调用任意的 rule api 或者 formatter api 去打包或者定义 rule or formatter。任意的 rule 都是独立的。没有特定的 coding style,你可以自己配置。
主页 | https://eslint.org/ |
源码 | https://github.com/eslint/eslint |
发布版本 | 4.12.0 |