# @alxwlw/oxlint-config 中文文档

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

版本：1\.9\.2
npm 元数据更新时间：2026-11-04T15:03:30.241Z
中文译文更新时间：2026-11-06T16:07:10.248Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：80.3 kB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- peer 依赖：oxlint \>=1\.74\.0，oxlint-tsgolint \>=0\.25\.0
- 首次发布：2026-09-18T11:10:08.881Z
- 最新版本发布：2026-11-04T15:03:29.905Z
- 近 30 天下载量：2781（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 19 个）

## 中文简介

克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克.

## 安装

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

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

## README

# @alxwlw/oxlint-配置

阿尔克瑟尔·林克恩 **克林特 1.x +克林特-特斯克林特**,用于重置 **类型脚本 7** (typescript-eslint直到 TS 7.1和上游不会支持7.0;tsgolint嵌入了打字符-go,所以 归宿 `typescript` 版本与林廷无关.

## 预设

| 预设 | 扩展 | 添加数 |
| --- | --- | --- |
| `base` | —— 说 | 正确性类别,全类型意识集(tsgolint),简单输入类型 |
| `node` | `base` | `stack/naming-convention` (在选择器设置上) |
| `nest` | `node` | `stack/require-nest-di-decorator`· ; `typescript/require-await` 关闭(最新的警卫合同); `typescript/consistent-type-imports` 关闭(安全进口) |
| `react` | `base` | 反应- hoks 经典配对 + eslint- plugin- 反应推荐 + jsx- a11y 推荐端口 |
| `next` | `react` | 奥克林特 `nextjs` 插件 |
| `library` | \- (重叠) | `stack/tsdoc-syntax` tS/TSX; 读取最接近的 `tsdoc.json` |

`base` 故意带一个 严格分类 键入字符串 `recommendedTypeChecked` 默认, 在错误级别上验证 生产中`no-unnecessary-condition`, (中文(简体) ), `no-deprecated`, (中文(简体) ), `restrict-template-expressions`(中文(简体) ). 较高级仍为a/ 单独闸门(oxlint不格式化); 依赖- cruiser 仍为 结构/循环引擎(`import/no-cycle` 离我远点.

## 使用量

```jsonc
// .oxlintrc.json (repo root)
{
    "extends": ["./node_modules/@alxwlw/oxlint-config/nest.jsonc"],
    "ignorePatterns": ["**/dist/**", "**/*.generated.*"],
}
```

```bash
oxlint --type-aware --report-unused-disable-directives --config .oxlintrc.json .
```

发布 API 层的软件包 `library` 其预设后覆盖( 不) 能够自行使用—— `stack` 插件来自预设 :

```jsonc
// .oxlintrc.json of the publishing package
{
    "extends": [
        "./node_modules/@alxwlw/oxlint-config/node.jsonc",
        "./node_modules/@alxwlw/oxlint-config/library.jsonc",
    ],
}
```

声明您自己的TSDoc 标签 `tsdoc.json` 而不是切换规则; 文件需要标准 `"$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json"` (没有它 tsdoc -配置报告) `Unsupported JSON "$schema" value`) (中文(简体) ). 覆盖在预设之后是故意的: 它不扩展 `base`因此无法 切换回什么 `nest` 或者说 `react` 关了.

对于混合回放中的浏览器代码, 丢入嵌入 `.oxlintrc.json` 扩展 `react.jsonc` 输入前端根 – 牛林自动发现 / 每个嵌入的配置 亚树(一个被嵌入的配置 REPLACES 是该亚树的根, 这就是为什么 `react.jsonc` 扩展 `base.jsonc` 页:1.

## 尖端(所有经验验证)

-   **`--type-aware` 是负载的.** 没有旗帜 每一个 `typescript/*` 类型意识规则是 SILENTLY 跳出 — 没有错误, 没有警告 。 把旗子放进去 重罚的任务; `oxlint-tsgolint` 必须安装(可选的对等点).
-   **构建 `.d.ts` 在知道类型之前** 在项目参考单列中 (单位:千美元)`tsc --build` 首先; 罐子月任务 `lint` 没有类型检查依赖性,因此适用于项目参考重置:未解决的进口产品 `error`\- 类型值 开火 `no-unsafe-*` 规则是幽灵.
-   **`plugins` 交叉合并 `extends`** ——添加插件列表的消费者 只有新的一个。 预设再次重复了完整的列表,所以每个列表读作: 一个文件( 见 `react.jsonc`(三); `oxlint-config.test.ts` 让他们完整.
-   **永远不要跑 `--fix-suggestions` 自动化**: 茨克林特语 `require-await` "建议"改写了公众签名(`Promise<T>` → `T`) (中文(简体) ). 平面 `--fix` 安全; 外部 `nest` (转出) `consistent-type-imports` 关闭) `consistent-type-imports` × `import/no-duplicates` 修补器可以 在一个导入对上相撞——秒 `--fix` 传球会汇合.
-   **程序外文件** (测试、工具配置文件、普通JS) tsgolint推断出严格的程序; `base.jsonc` 闪光镜 `disableTypeChecked` ——扩展在 消费针对特定方案外树的回购(`scripts/`, (中文(简体) ), `e2e/`, (中文(简体) ), 捆绑前端子目录). 工具配置文件是一个明确的列表 (vite/vitest/playwright/.);制作 `src/**/*.config.ts` 继续检查类型.
-   **`import type` 转换可以打破NestJS DI**数字 : `nest.jsonc` 关机 `typescript/consistent-type-imports` - 牛林没有模型 `emitDecoratorMetadata`,而规则的自定义用于转换导入 由 cr- param 类型注入到 `import type` (最后DI失败) 启动时 tsc 和 lint 保持绿色 。 巢穴消费者不再需要了 自己的覆盖; a `import type` 在 Nest 代码中注入类是一个错误 只有开始捕获。 明确 `@Inject(Class)` (这罐子) 该公约仍然是明确依赖性的任择方法.

## 这个 `stack` JS 插件

`./plugin` 输出内部规则(ESLint rule API, 由 oxlint 运行) `jsPlugins` 主机 – 需要通过 npm CLI 运行克林特, 每个月亮 任务 :

-   `stack/require-nest-di-decorator` 从私人ESLint规则移植 原件;见 `NOTICE` 因为来源。 两人已经不在了 锁上后会漂流.
-   `stack/naming-convention` —— canon 命名选择器集的端口; 选项 `{ "leadingUnderscore": "none" | "allow" | "allowSingleOrDouble" }` 页:1 重置为 a `_`\- 私人节制标记.
-   `stack/tsdoc-syntax` ——由本机启用 `library` 覆盖; 读取最近的 `tsdoc.json` (如斯林特-插管-tsdoc). `@microsoft/tsdoc`\- 支持的TSDoc验证 (slint-plugin-tsdoc 0.5要求: `eslint` 装入时包, 哪个 牛林消费者不再安装).

## 常见问题

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

克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克\.

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

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

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

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/alxwlw\_\_oxlint-config 是否存在。

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

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

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

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

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

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

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

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