# @deepvision/eslint-plugin 中文文档

规范地址：https://npmcn.com/package/%40deepvision/eslint-plugin/

版本：2\.1\.0
npm 元数据更新时间：2026-11-10T12:42:41.255Z
中文译文更新时间：2026-11-11T20:37:09.931Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40deepvision/eslint-plugin
原文对照：https://npmcn.com/package/%40deepvision/eslint-plugin/?lang=original
项目主页：https://github.com/deepvisionsoftware/eslint-plugin#readme
源码仓库：https://github.com/deepvisionsoftware/eslint-plugin

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：26.5 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：24
- 运行依赖：8 个
- 首次发布：2022-05-17T10:48:39.015Z
- 最新版本发布：2026-11-10T12:42:39.806Z
- 近 30 天下载量：4123（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：69（近 12 个月 16 个）

## 中文简介

这个软件包为后端(Node.js)和前端(Vue.js)项目提供即用ESLint配置.

## 安装

```sh
npm install @deepvision/eslint-plugin
```

也可以使用：`pnpm add @deepvision/eslint-plugin`、`yarn add @deepvision/eslint-plugin`、`bun add @deepvision/eslint-plugin`

## README

# 深视 ESLint 配置

这个软件包为后端(Node.js)和前端(Vue.js)项目提供即用ESLint配置.

## 特征

-   **全能解决方案**: 不需要单独安装 ESLint 或任何插件 - 全部包含在内
-   **类型脚本支持**: 已建入型号Script 林入型号
-   **标准规则**: 以 @stylistic/eslint-plugin 格式统一代码
-   **Vue.js 支持语录**: 完成 Vue 3 嵌入配置
-   **节点.js 支持**:后端节点js项目优化规则
-   **ESLint 9+ 兼容性**: 使用新的平面配置格式
-   **Oxlint + Oxfmt 预设**: Oxlint 和 Oxfmt 的规则相同(`@deepvision/eslint-plugin/oxc`),加上一个.vue-templades 唯一的 ESLint 配置

## 安装

```bash
npm install --save-dev @deepvision/eslint-plugin
```

这一一揽子计划包括所有必要的依赖。 没有额外安装 `eslint`, (中文(简体) ), `typescript-eslint`, (中文(简体) ), `eslint-plugin-vue`,或者需要任何其他与ESLint相关的软件包.

## 使用量

创建一个 `eslint.config.js` 中的文件,并导入相应的配置.

> 用于通用JS项目 `eslint.config.mjs`,以压制警告 `Module type of eslint.config.js is not specified`

### 后端 / 节点. js 项目

对于后端的Node.js项目(NestJS,Express等):

```js
import deepEslint, { defineConfig } from '@deepvision/eslint-plugin';

export default defineConfig([
  deepEslint.configs.node,
]);
```

### 前端 / Vue.js 项目

对于前端 Vue.js 项目:

```js
import deepEslint, { defineConfig } from '@deepvision/eslint-plugin';

export default defineConfig([
  deepEslint.configs.vue,
]);
```

### 克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克

相同的预设,用于插入的项目 [氧化剂](https://oxc.rs/docs/guide/usage/linter) 和格式为 [氧化剂](https://oxc.rs/docs/guide/usage/formatter) ——例如通过 [维特+](https://viteplus.dev/) (单位:千美元)`vp lint`, (中文(简体) ), `vp fmt`) (中文(简体) ). Oxlint在相同的规则上大约比ESLint快了50-100×.

-   `oxlint()` 联合来文/技术服务规则 `node` 财务报告和审定财务报表 `vue` 预设,规则用于规则(一个测试将其比作ESLint预设的有效配置).
-   `oxfmt` ——将预设的半个(@stylistic)格式化为Pretier相容物配置, `printWidth: 120`。 。 。 .
-   `configs.vueTemplates` Oxlint还不能做的一件事: **模板** 规则(slint-plugin-vue)和 `no-unused-vars` 内 `<script setup>`. ESLint 线条 `.vue` 仅保存文件,其布局规则已关闭,所以不会与 Oxfmt 战斗.

`vite.config.ts`数字 :

```ts
import { oxfmt, oxlint } from '@deepvision/eslint-plugin/oxc';
import { defineConfig } from 'vite-plus';

export default defineConfig({
  // Monorepo: say which globs are `node` and which are `vue`.
  lint: oxlint({
    node: ['apps/api/**'],
    vue: ['apps/app/**', 'libs/ui/**'],
    // Project overrides go after the preset's own.
    overrides: [
      { files: ['apps/api/**'], rules: { 'typescript/no-non-null-assertion': 'off' } },
    ],
  }),
  fmt: oxfmt,
});
```

一个Vue应用程序是 `oxlint({ vue: ['**'] })`。没有 Vite+,则将相同的对象写入 `.oxlintrc.json` 编号 : `.oxfmtrc.json`。 。 。 .

`eslint.config.js` 软件包 `.vue` 文件 :

```js
import deepEslint, { defineConfig } from '@deepvision/eslint-plugin';

export default defineConfig([
  deepEslint.configs.vueTemplates,
]);
```

```json
{
  "scripts": {
    "lint": "vp lint --fix src && eslint src --fix && vp fmt src"
  }
}
```

奥克林特规则名称: `typescript/*` 页:1 `@typescript-eslint/*`,且打字-slint扩展规则保留其核心名称(`no-unused-vars`) (中文(简体) ).

Oxc 预设未覆盖 :

-   `@stylistic/padding-line-between-statements` (前面的横线) `return`:Oxfmt保留了空白行但从未添加一行,而Oxlint没有这样的规则.
-   这个 `vue` 预设忽略 `src/graphql/**/*.ts`: 加进 `ignorePatterns` 你自己来.

### 软件包.json 脚本

向您添加 Linting 脚本 `package.json`数字 :

```json
{
  "scripts": {
    "lint": "eslint",
    "lint:fix": "eslint --fix"
  }
}
```

## 包含什么

本套件包括所有必要的依赖性:

-   `eslint` - 核心ESLint灯
-   `@eslint/js` -ESLint推荐的JavaScript规则
-   `typescript-eslint` - ESLint的脚本类型支持
-   `@stylistic/eslint-plugin` - 标准格式规则
-   `eslint-plugin-vue` - Vue.js 林克规则

你不需要单独安装这些东西!

## 运行 ESLint

设置后,可以使用:

```bash
# Check for linting errors
npm run lint

# Automatically fix issues
npm run lint:fix
```

## 许可证

麻省理工学院

## 常见问题

### @deepvision/eslint-plugin 是什么？

这个软件包为后端\(Node\.js\)和前端\(Vue\.js\)项目提供即用ESLint配置\.

### 如何安装 @deepvision/eslint-plugin？

在项目目录运行 npm install @deepvision/eslint-plugin，或使用 pnpm add / yarn add / bun add。

### @deepvision/eslint-plugin 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @deepvision/eslint-plugin 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @deepvision/eslint-plugin 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js 24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @deepvision/eslint-plugin 可以商用吗？

@deepvision/eslint-plugin 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @deepvision/eslint-plugin 的下载量有多少？

根据 npm 官方下载统计，@deepvision/eslint-plugin 在 2026/10/12 – 2026/11/10 这 30 天内被下载 4,123 次，日均约 137 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @deepvision/eslint-plugin 还在维护吗？

最新版本 2\.1\.0 发布于 2026/11/10（1 天前）；至今共发布 69 个版本，其中过去 12 个月发布了 16 个；首次发布于 2022/05/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。