@buildinams/lint

中文文档
1.0.1发布于 2026/03/04MITESM + CJS构建来源已验证近 30 天下载 2714

BiA 的基础 lint 配置( s) .

中文使用文档
文档目录10 节
  1. 所需资源
  2. 安装
  3. ESLint 语录
  4. 套装插件
  5. 自定义规则
  6. 高级
  7. 样式林
  8. 虚拟系统
  9. 从 v. 4. x 移动
  10. 捐款

线性

NPM version Actions Status PR Welcome

BiA 的基础 lint 配置( s) .

所需资源

  • 节点 >=20.19.0 | ESLint 语录 时间:
  • 类型脚本 >= 5.1.0, >=, 反应 >=17.0.0, (中文(简体) ), 高级 >= 3.0.0, >=, 样式林 16.0.0——视需要而定

使用 ESLint 软件 平面配置. 遗产 .eslintrc.* 不被支持.

安装

npm i -D @buildinams/lint eslint prettier stylelint

丢弃 prettier 和(或) stylelint 如果你不需要的话.

ESLint 语录

配置导出路径
Java 脚本@buildinams/lint/eslint/javascript
类型脚本@buildinams/lint/eslint/typescript
反应@buildinams/lint/eslint/react
反应 + 类型脚本@buildinams/lint/eslint/react-typescript
下一个.js@buildinams/lint/eslint/next
下一个.js + 类型脚本@buildinams/lint/eslint/next-typescript
// eslint.config.mjs
import config from "@buildinams/lint/eslint/next-typescript";
import { globalIgnores } from "eslint/config";

export default [
    ...config,
    globalIgnores([".next/**", "out/**", "build/**"]),
];
司法理事会
// eslint.config.js
module.exports = [...require("@buildinams/lint/eslint/next-typescript")];

套装插件

未用进口,简单进口型, 导入x, (中文(简体) ), 更美丽 (格式化出错误作为lint出错),反应+反应-hooks + jsx-a11y(反应/下), @next/slint-plugin-next (英语) (下个), 类型标记- slint (TS).

自定义规则

  • 进口订单= 绝对值(_, (中文(简体) ), ~ 前缀) 相对
  • type 结束 interface 通过 consistent-type-definitions
  • 无音符 ——使用 as const 相反(只有非自动固定规则)
  • 没有 console.log —— 说 warn 财务报告和审定财务报表 error 允许
  • 反应版本 默认为 19。对旧版本的覆盖:
// eslint.config.mjs
export default [
    ...config,
    { settings: { react: { version: "18" } } },
];

高级

// .prettierrc.mjs
export { default } from "@buildinams/lint/prettier";

跟踪逗号 "all" 双引号

格式化出错也会通过 ESLint 显示出错 eslint-plugin-prettier。 。 。 .

样式林

// .stylelintrc.json
{
    "extends": "@buildinams/lint/stylelint"
}

扩展 : 标准字符, (中文(简体) ), css-模块, (中文(简体) ), 休庭令, (中文(简体) ), 样式lint - prettier启用 scss/selector-no-redundant-nesting-selector。 。 。 .

自定义SCSS 函数
{
    "extends": "@buildinams/lint/stylelint",
    "rules": {
        "scss/function-no-unknown": [true, { "ignoreFunctions": ["px-to-rem"] }]
    }
}

虚拟系统

扩展名 : vscode-slint (英语), (中文(简体) ), 更美的 v 码, (中文(简体) ), vscode- stylelint (英语)

// .vscode/settings.json
{
    "editor.formatOnSave": false,
    "editor.defaultFormatter": "esbenp.prettier-vscode",
    "editor.codeActionsOnSave": {
        "source.fixAll.eslint": "explicit",
        "source.fixAll.stylelint": "explicit"
    },
    "scss.validate": false,
    "stylelint.validate": ["scss"]
}

从 v. 4. x 移动

  1. 更新到ESLint 9+和节点20+
  2. 删除 .eslintrc.*
  3. 创建 eslint.config.mjs (见上文)

键 @buildinams/[email protected] 如果停留在ESLint 8上.

捐款

有问题吗? 想要个新角色吗? 参与进来。 。 。 .

版本与发布记录

@buildinams/lint 共发布 15 个版本,首次发布于 2023/01/19;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.0.1latest2026/03/048 个月前
1.0.02026/03/048 个月前
0.4.32025/02/181.7 年前
0.4.22024/01/162 年前
0.4.12024/01/162 年前
0.4.02024/01/022 年前

关于 @buildinams/lint 的常见问题

@buildinams/lint 是什么?

BiA 的基础 lint 配置( s) .

如何安装 @buildinams/lint?

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

@buildinams/lint 支持 TypeScript 吗?

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

@buildinams/lint 支持 ESM 还是 CommonJS?

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

@buildinams/lint 需要什么版本的 Node.js?

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

@buildinams/lint 可以商用吗?

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

@buildinams/lint 的下载量有多少?

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

@buildinams/lint 还在维护吗?

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