Skip to content
← Back to rules

vitest/prefer-importing-vitest-globals Style

🛠️ An auto-fix is available for this rule.

作用

强制显式从 'vitest' 导入,而不是使用 vitest 全局变量。

为什么这不好?

不导入而直接使用 vitest 全局变量会依赖隐式的全局配置 (vitest 配置中的 globals: true)。显式导入可以让依赖关系更清晰, 提升 IDE 支持,并确保在不同设置下都能兼容。

示例

以下是此规则的错误代码示例:

js
describe("suite", () => {
  it("test", () => {
    expect(true).toBe(true);
  });
});

以下是此规则的正确代码示例:

js
import { describe, it, expect } from "vitest";

describe("suite", () => {
  it("test", () => {
    expect(true).toBe(true);
  });
});

如何使用

To enable this rule using the config file or in the CLI, you can use:

json
{
  "plugins": ["vitest"],
  "rules": {
    "vitest/prefer-importing-vitest-globals": "error"
  }
}
ts
import { defineConfig } from "oxlint";

export default defineConfig({
  plugins: ["vitest"],
  rules: {
    "vitest/prefer-importing-vitest-globals": "error",
  },
});
bash
oxlint --deny vitest/prefer-importing-vitest-globals --vitest-plugin

版本

此规则在 v1.59.0 中添加。

参考资料