@alephic/eslint-plugin

中文文档
0.2.0发布于 2026/10/02MITTypeScriptES Module构建来源已验证近 30 天下载 2892

Alephic 的自定义 ESLint 规则

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 规则
  4. 捐款
  5. 发布最新消息
  6. 许可证

@alephic/eslint-plugin (英语)

阿莱菲克的习俗ESLint规则.

安装

pnpm add -D @alephic/eslint-plugin

需要ESLint QQ 9(平面配置).

使用量

// eslint.config.js
import alephic from '@alephic/eslint-plugin'
import { defineConfig } from 'eslint/config'

export default defineConfig([...alephic.configs.recommended])

或者单独配置规则 :

import alephic from '@alephic/eslint-plugin'
import { defineConfig } from 'eslint/config'

export default defineConfig([
  {
    plugins: { '@alephic': alephic },
    rules: {
      '@alephic/symmetric-never-exclusions': 'error',
    },
  },
])

规则

QQ 配置启用 .
设置在 recommended 配置 .
自动修复 --fix CLI 选项。 。 。 .

名称                      说明💼🔧
对称- 绝不排斥强制对称性? :从不排斥受歧视的工会类型✅🔧
测试操作码需要测试描述/it标题来命名文件实际引用的标识符,因此测试要练习真实的代码,而不是并行的再执行.✅

捐款

pnpm install
pnpm test    # vitest rule-tester suites (watch mode locally, single run in CI)
pnpm lint    # eslint --fix + prettier --write + typecheck
pnpm build   # tsdown → dist/ (ESM)
pnpm build && pnpm eslint-doc-generator   # regenerate rules docs

新规则进入 src/rules/<rule-name>.ts 与合用地点 <rule-name>.test.ts (单位:千美元) docs/rules/<rule-name>.md 页面,并且必须是 登记在册 src/index.ts (两者) rules 财务报告和审定财务报表 configs.recommended ——默认 严重性是 error) (中文(简体) ). 添加或编辑规则后运行 pnpm build && pnpm eslint-doc-generator 重新生成 README 规则表 财务报告和审定财务报表 docs/rules 页眉( 生成器将插件从 dist/页:1 失败了,如果他们是呆子.

发布最新消息

释放是自动的 变化数字 :

  1. 在你的公关,运行 pnpm changeset 然后挑个接头 增加或收紧规则 实值 对消费者的突破 (新的 CI 失败) - 使用大起大落 一旦超过 1. 0; 错误修正只去除假阳性是补丁 .
  2. 合并公关. 释放工作在 ci.yml 打开(或更新) a chore: release 正在累积等待更改的 PR 及其更改日志 条目.
  3. 合并发布公关. 一旦CI工作通过 主,释放工作 将新版本发布到 npmjs( 通过信任的出版/ OIDC, 使用 页:1.

没有 npm 符号涉及: npmjs 信任 ci.yml 工作流程直接.

许可证

麻省理工学院

版本与发布记录

@alephic/eslint-plugin 共发布 5 个版本,首次发布于 2026/07/31;过去 12 个月发布了 5 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.0latest2026/10/021 个月前
0.1.32026/09/301 个月前
0.1.22026/07/313 个月前
0.1.12026/07/313 个月前
0.1.02026/07/313 个月前

关于 @alephic/eslint-plugin 的常见问题

@alephic/eslint-plugin 是什么?

Alephic 的自定义 ESLint 规则

如何安装 @alephic/eslint-plugin?

在项目目录运行 npm install @alephic/eslint-plugin,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:eslint(>=9)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@alephic/eslint-plugin 支持 TypeScript 吗?

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

@alephic/eslint-plugin 支持 ESM 还是 CommonJS?

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

@alephic/eslint-plugin 需要什么版本的 Node.js?

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

@alephic/eslint-plugin 可以商用吗?

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

@alephic/eslint-plugin 的下载量有多少?

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

@alephic/eslint-plugin 还在维护吗?

最新版本 0.2.0 发布于 2026/10/02(1 个月前);至今共发布 5 个版本,其中过去 12 个月发布了 5 个;首次发布于 2026/07/31。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。