# @codacy/tools-biome-2 中文文档

规范地址：https://npmcn.com/package/%40codacy/tools-biome-2/

版本：0\.28\.0
npm 元数据更新时间：2026-11-09T13:48:28.952Z
中文译文更新时间：2026-11-10T05:44:18.302Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40codacy/tools-biome-2
原文对照：https://npmcn.com/package/%40codacy/tools-biome-2/?lang=original
项目主页：https://github.com/codacy/analysis-cli
源码仓库：https://github.com/codacy/analysis-cli

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

- 包体积（解压后）：182 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2026-04-10T12:33:25.607Z
- 最新版本发布：2026-11-09T13:48:28.696Z
- 近 30 天下载量：11791（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

活体适配器- CLI- mode JavaScript/ TypeScript/ CSS/JSON linter

## 安装

```sh
npm install @codacy/tools-biome-2
```

也可以使用：`pnpm add @codacy/tools-biome-2`、`yarn add @codacy/tools-biome-2`、`bun add @codacy/tools-biome-2`

## README

# @codacy/tools-biome-2 (英语)

## 目录

-   [概览](https://npmcn.com/package/%40codacy/tools-biome-2/#readme-overview)
-   [更新图案](https://npmcn.com/package/%40codacy/tools-biome-2/#readme-updating-patterns)
-   [更新 Biome 版本](https://npmcn.com/package/%40codacy/tools-biome-2/#readme-updating-the-biome-version)
-   [发展](https://npmcn.com/package/%40codacy/tools-biome-2/#readme-development)
-   [维护者的注释](https://npmcn.com/package/%40codacy/tools-biome-2/#readme-notes-for-maintainers)

* * *

## 概览

JavaScript/TypeScript/CSS/JSON 插件使用 [生物体](https://biomejs.dev/) 二进制. Biome是一款用Rust书写的快速网络工具链,它提供林入,格式化和导入排序. 使用CLI执行策略. 二进制来自 `@biomejs/biome` npm 软件包, 是一个按需 _有效载数_ 而不是依赖: `install` 运行 `npm ci` 对所犯 `payload/package-lock.json`,因此npm在运行它的机器上选择了正确的平台二进制(包括musl).

| 财产 | 数值 |
| --- | --- |
| 工具标识 | `Biome` |
| 编码 UUID | `934a97f8-835c-42fc-a6d1-02bdfca3bdfa` |
| 战略 | CLI(npm有效载荷,按需安装) |
| 语文 | JavaScript, TypeScript, JSX, TSX, JSON, CSS 软件 |
| 二进制 | `@biomejs/biome` npm 软件包 |
| 文件图案 | `**/*.js`, (中文(简体) ), `**/*.jsx`, (中文(简体) ), `**/*.ts`, (中文(简体) ), `**/*.tsx`, (中文(简体) ), `**/*.json`, (中文(简体) ), `**/*.css` |
| 图案计数 | ~466 (英语) |

## 更新图案

```bash
# Re-fetch pattern metadata from the Codacy API
pnpm prefetch

# Commit the result
git add src/patterns.json
```

模式 ID 遵循格式 `Biome_lint_suspicious_noDoubleEquals`, (中文(简体) ), `Biome_lint_correctness_noUnusedVariables`等 (中文(简体) ).

## 更新 Biome 版本

1.  更新 `preferredVersion` 内 `src/metadata.ts`
2.  更新 `@biomejs/biome` 版本在 `devDependencies` 联 合 国 `package.json`
3.  运行 `pnpm install` 获取新的二进制
4.  运行 `pnpm generate-payloads biome-2` 从重播根到重播 `payload/package.json` 并重生其锁文件
5.  运行 `pnpm prefetch` - Biome经常增加新规则
6.  运行 `pnpm test` 以验证兼容性
7.  如果主要版本更改,请创建新的适配软件包(`biome-3/`(中文(简体) )

## 发展

```bash
pnpm build    # Build with tsup
pnpm test     # Run tests (the payload is a devDependency, so no install is needed)
```

## 维护者的注释

-   **预设绘图`src/pattern-mappings.json`(中文(简体) )**: 标记只——Biome的图案ID是 `lint/<group>/<rule>` 而路径中没有框架,所以标记是唯一的信号. `drizzle-orm` 财务报告和审定财务报表 `turborepo` 被添加到三个育婴规则 命名这些工具. 这个 `test`\- 还有 `a11y`\- 标记的规则是故意普遍的:它们只匹配测试或 JSX的语法,所以他们是惰性的,而不是在既无又无的回扣中吵闹.
    
-   Biome是一个独立的Rust 二进制,通过Biome系统分布 `@biomejs/biome` npm 有特定平台的可选依赖性包 (`@biomejs/cli-darwin-arm64`, (中文(简体) ), `@biomejs/cli-linux-x64`(见a/c.5/49/70,附件).
    
-   适配器从 `@biomejs/biome/bin/biome` (联署材料包装) `node`。 。 。 .
    
-   通过 JSON 输出 `biome lint --reporter=json` ——JSON被放出去Stdout,而stderr包含不稳定的API警告(由适配器过滤出).
    
-   出站代码为0=清理,1=发现出站问题(正常),2+=出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站出站.
    
-   `--config-path` 接受一个 **目录** 路径(寻找生物) `biome.json` 在它内部.
    
-   **关键**: 生成 `biome.json` 必须写入临时目录 **外部** 存储器。 Biome 2.x 处理任何 `biome.json` 在回波分层内作为嵌入根配置,如果回波级别上已经存在隐含的根,则用"Found a 嵌入根配置"出错. 写入 `os.tmpdir()` 避免这个.
    
-   当指定模式时, a `biome.json` 配置以 `recommended: false` 并且只允许要求的规则.
    
-   配置文件搜索顺序 : `biome.json`, (中文(简体) ), `biome.jsonc`, (中文(简体) ), `.biome.json`, (中文(简体) ), `.biome.jsonc`。 。 。 .
    
-   Biome报告1行和栏号——不需要转换.
    
-   JSON输出中的文件路径与工作目录相对.

## 常见问题

### @codacy/tools-biome-2 是什么？

活体适配器- CLI- mode JavaScript/ TypeScript/ CSS/JSON linter

### 如何安装 @codacy/tools-biome-2？

在项目目录运行 npm install @codacy/tools-biome-2，或使用 pnpm add / yarn add / bun add。

### @codacy/tools-biome-2 支持 TypeScript 吗？

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

### @codacy/tools-biome-2 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @codacy/tools-biome-2 需要什么版本的 Node\.js？

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

### @codacy/tools-biome-2 可以商用吗？

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

### @codacy/tools-biome-2 的下载量有多少？

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

### @codacy/tools-biome-2 还在维护吗？

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