@alxwlw/oxlint-config

中文文档
1.9.2发布于 2026/11/04MITES Module构建来源已验证近 30 天下载 2781

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

中文使用文档
文档目录4 节
  1. 预设
  2. 使用量
  3. 尖端(所有经验验证)
  4. 这个 stack JS 插件

@alxwlw/oxlint-配置

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

预设

预设扩展添加数
base—— 说正确性类别,全类型意识集(tsgolint),简单输入类型
nodebasestack/naming-convention (在选择器设置上)
nestnodestack/require-nest-di-decorator· ; typescript/require-await 关闭(最新的警卫合同); typescript/consistent-type-imports 关闭(安全进口)
reactbase反应- hoks 经典配对 + eslint- plugin- 反应推荐 + jsx- a11y 推荐端口
nextreact奥克林特 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 离我远点.

使用量

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

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

// .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 共发布 19 个版本,首次发布于 2026/09/18;过去 12 个月发布了 19 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.9.2latest2026/11/043 天前
1.9.12026/11/035 天前
1.9.02026/10/299 天前
1.8.02026/10/2612 天前
1.7.12026/10/2216 天前
1.7.02026/10/2216 天前

关于 @alxwlw/oxlint-config 的常见问题

@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 和提交记录判断。