# @buildinams/lint 中文文档

规范地址：https://npmcn.com/package/%40buildinams/lint/

版本：1\.0\.1
npm 元数据更新时间：2026-03-04T09:27:38.664Z
中文译文更新时间：2026-11-08T19:48:49.851Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：20.8 kB，39 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.19\.0
- 运行依赖：18 个
- peer 依赖：eslint \>=9\.0\.0 \<11，prettier \>=3\.0\.0，react \>=17\.0\.0 \|\| 18 \|\| 19，stylelint \>=16\.0\.0，typescript \>=5\.1\.0
- 首次发布：2023-01-19T09:34:15.315Z
- 最新版本发布：2026-03-04T09:27:38.306Z
- 近 30 天下载量：2714（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 2 个）

## 中文简介

BiA 的基础 lint 配置( s) .

## 安装

```sh
npm install @buildinams/lint
```

也可以使用：`pnpm add @buildinams/lint`、`yarn add @buildinams/lint`、`bun add @buildinams/lint`

## README

# 线性

[![NPM version](https://img.shields.io/npm/v/@buildinams/lint.svg?style=flat-square&logo=react)](https://npmjs.org/package/@buildinams/lint) [![Actions Status](https://github.com/buildinamsterdam/lint/actions/workflows/lint.yml/badge.svg)](https://github.com/buildinamsterdam/lint/actions) [![PR Welcome](https://img.shields.io/npm/dm/@buildinams/lint.svg)](https://npmcharts.com/compare/@buildinams/lint?minimal=true)

BiA 的基础 lint 配置( s) .

## 所需资源

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

使用 ESLint 软件 [平面配置](https://eslint.org/docs/latest/use/configure/configuration-files). 遗产 `.eslintrc.*` 不被支持.

## 安装

```bash
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` |

```js
// eslint.config.mjs
import config from "@buildinams/lint/eslint/next-typescript";
import { globalIgnores } from "eslint/config";

export default [
    ...config,
    globalIgnores([".next/**", "out/**", "build/**"]),
];
```

司法理事会

```js
// eslint.config.js
module.exports = [...require("@buildinams/lint/eslint/next-typescript")];
```

### 套装插件

未用进口,简单进口型, [导入x](https://github.com/un-ts/eslint-plugin-import-x), (中文(简体) ), [更美丽](https://www.npmjs.com/package/eslint-plugin-prettier) (格式化出错误作为lint出错),反应+反应-hooks + jsx-a11y(反应/下), [@next/slint-plugin-next (英语)](https://www.npmjs.com/package/@next/eslint-plugin-next) (下个), [类型标记- slint](https://typescript-eslint.io/) (TS).

### 自定义规则

-   **进口订单**\= 绝对值(`_`, (中文(简体) ), `~` 前缀) 相对
-   **`type` 结束 `interface`** 通过 `consistent-type-definitions`
-   **无音符** ——使用 `as const` 相反(只有非自动固定规则)
-   **没有 `console.log`** —— 说 `warn` 财务报告和审定财务报表 `error` 允许
-   **反应版本** 默认为 `19`。对旧版本的覆盖:

```js
// eslint.config.mjs
export default [
    ...config,
    { settings: { react: { version: "18" } } },
];
```

## 高级

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

跟踪逗号 `"all"` 双引号

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

## 样式林

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

扩展 : [标准字符](https://www.npmjs.com/package/stylelint-config-standard-scss), (中文(简体) ), [css-模块](https://www.npmjs.com/package/stylelint-config-css-modules), (中文(简体) ), [休庭令](https://www.npmjs.com/package/stylelint-config-recess-order), (中文(简体) ), [样式lint - prettier](https://www.npmjs.com/package/stylelint-prettier)启用 `scss/selector-no-redundant-nesting-selector`。 。 。 .

自定义SCSS 函数

```json
{
    "extends": "@buildinams/lint/stylelint",
    "rules": {
        "scss/function-no-unknown": [true, { "ignoreFunctions": ["px-to-rem"] }]
    }
}
```

## 虚拟系统

扩展名 : [vscode-slint (英语)](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint), (中文(简体) ), [更美的 v 码](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode), (中文(简体) ), [vscode- stylelint (英语)](https://marketplace.visualstudio.com/items?itemName=stylelint.vscode-stylelint)

```json
// .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/lint@0.4.x` 如果停留在ESLint 8上.

## 捐款

有问题吗? 想要个新角色吗? [参与进来](https://github.com/buildinamsterdam/lint/blob/main/CONTRIBUTING.md)。 。 。 .

## 常见问题

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