Skip to main content

prefer-namespace-keyword

Require using namespace keyword over module keyword to declare custom TypeScript modules.

🎨

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

🔧

此规则报告的一些问题可通过 --fix ESLint 命令行选项自动修复。


TypeScript 历史上允许一种称为 "定制模块" (module Example {}) 的代码组织形式，后来重命名为 "namespaces" (namespace Example)。

英：TypeScript historically allowed a form of code organization called "custom modules" (module Example {}), later renamed to "namespaces" (namespace Example).

命名空间是一种过时的组织 TypeScript 代码的方式。 现在首选 ES2015 模块语法 (import/export)。

英：Namespaces are an outdated way to organize TypeScript code. ES2015 module syntax is now preferred (import/export).

对于仍然使用自定义模块/命名空间的项目，最好将它们称为命名空间。 当使用 module 关键字而不是 namespace 时，此规则会报告。

英：For projects still using custom modules / namespaces, it's preferred to refer to them as namespaces. This rule reports when the module keyword is used instead of namespace.

此规则不报告使用 TypeScript 模块声明来描述外部 API (declare module 'foo' {})。

.eslintrc.cjs
module.exports = {
  "rules": {
    "@typescript-eslint/prefer-namespace-keyword": "error"
  }
};
在线运行试试这个规则 ↗

示例​

module Example {}
Open in Playground

何时不使用它​

如果你不使用 TypeScript 较旧的 module/namespace 关键字，那么你将不需要此规则。

英：If you are not using TypeScript's older module/namespace keywords, then you will not need this rule.

进一步阅读​

选项​

该规则不可配置。

资源​