# @anolilab/oxlint-config 中文文档

规范地址：https://npmcn.com/package/%40anolilab/oxlint-config/

版本：2\.0\.3
npm 元数据更新时间：2026-11-04T20:17:18.409Z
中文译文更新时间：2026-11-06T05:38:42.838Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40anolilab/oxlint-config
原文对照：https://npmcn.com/package/%40anolilab/oxlint-config/?lang=original
项目主页：https://anolilab.com/nodejs/packages/oxlint-config
源码仓库：https://github.com/anolilab/javascript-style-guide

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

- 包体积（解压后）：559 kB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0 \<=25\.\*
- 运行依赖：6 个
- peer 依赖：oxlint 1\.89\.0，oxlint-tsgolint 7\.0\.2005
- 首次发布：2026-07-21T19:24:16.380Z
- 最新版本发布：2026-11-04T20:17:17.949Z
- 近 30 天下载量：4734（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

牛林可分享配置为Anolilab.

## 安装

```sh
npm install @anolilab/oxlint-config
```

也可以使用：`pnpm add @anolilab/oxlint-config`、`yarn add @anolilab/oxlint-config`、`bun add @anolilab/oxlint-config`

## README

[![oxlint-config](https://npmcn.com/package/%40anolilab/oxlint-config/__assets__/package-og.svg)](https://github.com/anolilab/semantic-release)

### 牛林可分享配置为Anolilab.

  

[![typescript-image](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript&logoColor=fff&style=flat-square)](https://www.typescriptlang.org/ "TypeScript") [![mit licence](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](https://npmcn.com/package/%40anolilab/oxlint-config/LICENSE.md)

* * *

可分享 [奥克林特](https://oxc.rs/docs/guide/usage/linter) anolilab 的配置 。 这个 启用 `correctness` 分类和列出它根据名字 打开的所有其他规则,所以没有规则 仅按类别开关。 它离开 `style` 类别改为 [`@anolilab/oxfmt-config`](https://anolilab.com/nodejs/packages/oxfmt-config)。 。 。 .

## 安装

```sh
npm install --save-dev @anolilab/oxlint-config oxlint oxlint-tsgolint
```

```sh
pnpm add -D @anolilab/oxlint-config oxlint oxlint-tsgolint
```

> `oxlint` 财务报告和审定财务报表 `oxlint-tsgolint` 是同伴的依赖关系。 在此套件旁同时安装 。 这个 配置打开了机型的 linting, 而 oxlint 寻找 `oxlint-tsgolint` 在你的项目. 没有它,牛林就停了 `Failed to find tsgolint executable`。 。 。 .

## 设置

运行安装器到脚手架 a `.oxlintrc.json` 为你:

```sh
npx oxlint-config:install
```

或者用手动把它接上——有两种方式来消耗.

**`.oxlintrc.json` (按路径扩展)**

oxlint 的 JSON 配置不能导入 npm 包, 所以 `extends` 内部文件的分数 `node_modules`数字 :

```json
{
    "$schema": "./node_modules/oxlint/configuration_schema.json",
    "extends": ["./node_modules/@anolilab/oxlint-config/.oxlintrc.json"],
    "rules": {}
}
```

**`oxlint.config.ts` (输入对象)**

```ts
import config from "@anolilab/oxlint-config";

export default config;
```

## 覆盖

放松或收紧在共享基础上的个别规则:

```json
{
    "extends": ["./node_modules/@anolilab/oxlint-config/.oxlintrc.json"],
    "rules": {
        "no-console": "off"
    }
}
```

顶级 `rules` 输给预设的每个文件类型 `overrides` (见 [它的设定](https://npmcn.com/package/%40anolilab/oxlint-config/#readme-what-it-sets)) (中文(简体) ). 预设规则也为 `**/*.tsx`, (中文(简体) ), `**/*.jsx` 或者说 `**/*.{cjs,mjs,js}` 保留预设 这些文件的值, 即使您的顶级 `rules` 关掉 换个地方,摆好 在你自己的超能力。 您的超接功能在预设后应用 :

```json
{
    "extends": ["./node_modules/@anolilab/oxlint-config/.oxlintrc.json"],
    "overrides": [
        {
            "files": ["**/*"],
            "rules": {
                "no-console": "off"
            }
        }
    ]
}
```

### 自动 JSX 运行时间

预设转弯 `react/react-in-jsx-scope` 为: `.tsx` 财务报告和审定财务报表 `.jsx` 文件,作为 `@anolilab/eslint-config` 用于经典运行时间. `@anolilab/eslint-config` 当 tsconfig 设定时关闭规则 `jsx` 改为 `react-jsx` 或者说 `react-jsxdev`但 JSON 配置不能读取 tsconfig 。 为了得到同样的 结果, 使用 `oxlint.config.ts` 财务报告和审定财务报表 `jsxRuntimeOverrides`。它返回每个列出的覆盖 使用自动运行时间的 tsconfig :

```ts
import config, { jsxRuntimeOverrides } from "@anolilab/oxlint-config";

export default {
    ...config,
    overrides: [...config.overrides, ...jsxRuntimeOverrides(["tsconfig.json", "packages/app/tsconfig.json"])],
};
```

在一个 `.oxlintrc.json`,添加一个翻转 `react/react-in-jsx-scope` 取而代之的是这些文件.

## 它的设定

-   `categories`数字 : `correctness: "error"`
-   `overrides`: 每个文件类型有一个条目,其规则与类型脚本规则不同: `**/*.{cjs,mjs,js}`, (中文(简体) ), `**/*.jsx`, (中文(简体) ), `**/*.tsx`。每个值使用值 `@anolilab/eslint-config` 这些文件的设置
-   `plugins`数字 : `typescript`, (中文(简体) ), `unicorn`, (中文(简体) ), `oxc`, (中文(简体) ), `import`, (中文(简体) ), `promise`, (中文(简体) ), `node`, (中文(简体) ), `jsdoc`, (中文(简体) ), `react`, (中文(简体) ), `jsx-a11y`
-   `jsPlugins`数字 : `sonarjs`, (中文(简体) ), `regexp`, (中文(简体) ), `eslint-comments`, (中文(简体) ), `no-secrets`, (中文(简体) ), `react-doctor`. ESLint 插件 牛林的负载不变,有规则 `@anolilab/eslint-config` \* 使他们能够,并且 [`oxlint-plugin-react-doctor`](https://www.npmjs.com/package/oxlint-plugin-react-doctor) 规则设定.
-   `rules`: 每个规则克林特执行 `@anolilab/eslint-config` 启用 TypeScript 文件, 带有 ESLint 的重度和选项 。 所有其他规则的克林特工具都被设定为 `off` 因此,预设从不按类别切换规则.
-   **类型意识规则.** `options.typeAware` 开始,所以 `typescript/*` 需要类型的规则 信息流经 [`oxlint-tsgolint`](https://www.npmjs.com/package/oxlint-tsgolint)该 软件包必须安装在 `oxlint`1\. 消费者确定自己的 `options` 拿着 设置.
-   **斯为相等.** 每一个规则 `@anolilab/eslint-config` 运行于 `error` 或者说 `warn` 运行于这里 同样严重。 联合国的规则 `style`, (中文(简体) ), `restriction` 财务报告和审定财务报表 `nursery` eSLint 允许的类别 明确列出.
-   **反应医生.** 其规则是允许的,除了牛林已经在本地运行的80个 同名( 例如) `jsx-a11y/alt-text`, (中文(简体) ), `react/rules-of-hooks`, (中文(简体) ), `no-eval`因此,没有发现是 报告两次。 反应医生比本地人更严格的地方, 本地人的规则被固定在 反应医生的严重性。 与同一概念的ESLint规则相匹配的反应医生规则是: `error` 并关闭 ESLint 规则,但只有在其插件被装入时。 其余的则 `warn`。 。 。 .

### 未迁移

每一个规则 `@anolilab/eslint-config` 启用此文件类型相同的 oxlint 工具 。 这些不是:

-   `no-undef`: 预设声明没有全局, 因此它会报告 `module`, (中文(简体) ), `process` 和浏览器全域。 放在ESLint内.
-   选项 oxlint 不接受 。 规则以 ESLint 的重度运行,并带有默认选项: `preserve-caught-error`, (中文(简体) ), `unicorn/escape-case`, (中文(简体) ), `unicorn/filename-case`, (中文(简体) ), `unicorn/no-array-callback-reference`, (中文(简体) ), `unicorn/no-empty-file`, (中文(简体) ), `unicorn/no-unreadable-array-destructuring`, (中文(简体) ), `unicorn/prefer-add-event-listener`, (中文(简体) ), `unicorn/prefer-array-find`, (中文(简体) ), `unicorn/prefer-array-flat`, (中文(简体) ), `unicorn/prefer-set-has`。 。 。 .
-   规则克林特没有执行,所以他们留在ESLint. 这些是 `unicorn`, (中文(简体) ), `jsdoc`, (中文(简体) ), `perfectionist`, (中文(简体) ), `react-x`, (中文(简体) ), `n`, (中文(简体) ), `antfu`, (中文(简体) ), `e18e`, (中文(简体) ), `import`, (中文(简体) ), `react` 财务报告和审定财务报表 `@stylistic` 规则ESLint使得克林特没有规则 `camelcase`, (中文(简体) ), `no-restricted-syntax`, (中文(简体) ), `no-return-await` 财务报告和审定财务报表 `no-undef-init` 在核心规则中.
-   其他语言(JSON,YAML,TOML,Markdown,CSS,HTML,Astro)和框架插件(故事本,测试库,Playwright,TanStack,Tailwind,UnoCSS,Zod,Vitest)的规则. 那些留在ESLint监狱.

这个 `style` 类别作为一个类别被删除——格式化是前题的工作。 以上明确列出ESLint的规则。 配对这个 与 [`@anolilab/oxfmt-config`](https://anolilab.com/nodejs/packages/oxfmt-config)。 。 。 .

`@anolilab/eslint-config` 在文件出现时读取 并关闭它运行的规则,所以 没有规则报告两次.

## 相关

-   [`@anolilab/oxfmt-config`](https://anolilab.com/nodejs/packages/oxfmt-config)
-   [`@anolilab/eslint-config`](https://anolilab.com/nodejs/packages/eslint-config)

## 常见问题

### @anolilab/oxlint-config 是什么？

牛林可分享配置为Anolilab\.

### 如何安装 @anolilab/oxlint-config？

在项目目录运行 npm install @anolilab/oxlint-config，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：oxlint（1\.89\.0）、oxlint-tsgolint（7\.0\.2005）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @anolilab/oxlint-config 支持 TypeScript 吗？

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

### @anolilab/oxlint-config 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @anolilab/oxlint-config 需要什么版本的 Node\.js？

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

### @anolilab/oxlint-config 可以商用吗？

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

### @anolilab/oxlint-config 的下载量有多少？

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

### @anolilab/oxlint-config 还在维护吗？

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