# @brazilian-utils/brazilian-utils 中文文档

规范地址：https://npmcn.com/package/%40brazilian-utils/brazilian-utils/

版本：2\.5\.0
npm 元数据更新时间：2026-10-09T03:08:02.191Z
中文译文更新时间：2026-11-08T14:21:21.637Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40brazilian-utils/brazilian-utils
原文对照：https://npmcn.com/package/%40brazilian-utils/brazilian-utils/?lang=original
项目主页：https://brazilian-utils.com.br/
源码仓库：https://github.com/brazilian-utils/javascript

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

- 包体积（解压后）：13.8 MB，951 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：^20\.19\.0 \|\| \>=22\.12\.0
- 运行依赖：0 个
- 首次发布：2020-01-13T17:26:13.945Z
- 最新版本发布：2026-10-03T17:58:17.593Z
- 近 30 天下载量：160786（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 7 个）

## 中文简介

巴西数据的零依赖性、可树动类型Script公用事业:验证、格式、剖析和生成CPF、CNPJ、CEP、Boleto、Pix、电话、节假日等.

## 安装

```sh
npm install @brazilian-utils/brazilian-utils
```

也可以使用：`pnpm add @brazilian-utils/brazilian-utils`、`yarn add @brazilian-utils/brazilian-utils`、`bun add @brazilian-utils/brazilian-utils`

## README

![Brazilian Utils](https://raw.githubusercontent.com/brazilian-utils/brand/main/github-hero/github-hero-js.png)

巴西的公用事业数据:CPF、CNPJ、CEP、Boleto、Pix、假日等.

[页:1](https://brazilian-utils.com.br/getting-started)

[![npm version](https://img.shields.io/npm/v/@brazilian-utils/brazilian-utils.svg)](https://www.npmjs.com/package/@brazilian-utils/brazilian-utils) [![Downloads per month](https://img.shields.io/npm/dm/@brazilian-utils/brazilian-utils.svg)](https://www.npmjs.com/package/@brazilian-utils/brazilian-utils) [![License: MIT](https://img.shields.io/github/license/brazilian-utils/javascript.svg)](https://github.com/brazilian-utils/javascript/blob/main/LICENSE) [![Zero dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](https://github.com/brazilian-utils/javascript/blob/main/CONTRIBUTING.md#zero-runtime-dependencies) [![TypeScript](https://img.shields.io/npm/types/@brazilian-utils/brazilian-utils)](https://www.npmjs.com/package/@brazilian-utils/brazilian-utils) [![Build Status](https://github.com/brazilian-utils/javascript/actions/workflows/build.yml/badge.svg?branch=main)](https://github.com/brazilian-utils/javascript/actions/workflows/build.yml?query=branch%3Amain) [![Tests](https://github.com/brazilian-utils/javascript/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/brazilian-utils/javascript/actions/workflows/tests.yml?query=branch%3Amain) [![codecov](https://codecov.io/gh/brazilian-utils/javascript/branch/main/graph/badge.svg)](https://codecov.io/gh/brazilian-utils/javascript) [![Mutation tests](https://github.com/brazilian-utils/javascript/actions/workflows/mutation.yml/badge.svg?branch=main)](https://github.com/brazilian-utils/javascript/actions/workflows/mutation.yml?query=branch%3Amain) [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/brazilian-utils/javascript/badge)](https://scorecard.dev/viewer/?uri=github.com/brazilian-utils/javascript) [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/14695/badge)](https://www.bestpractices.dev/projects/14695)

**目录**

-   [开始](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-getting-started)
    -   [为什么巴西的Utils](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-why-brazilian-utils)
    -   [安装](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-installation)
        -   [运行时间支持](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-runtime-support)
    -   [使用量](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-usage)
    -   [发展](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-development)
    -   [贡献者](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-contributors)
    -   [许可证](https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-license)

# 开始

巴西Utils是一个零依赖性小公用设施库,用于解决巴西制造软件的日常问题:验证、格式化、剖析和生成CPF、CNPJ、CEP、Boleto、Pix、电话号码、假日等等.

## 为什么巴西的Utils

-   **零运行时间依赖关系.** 你身上没有别的东西 `node_modules` 或者在你的捆绑.
-   **树能震动,下至功能.** `import { isValidCpf }` 成本约为0.5 KB 精密(0.3 KB gziped). 每个管子也是它自己的子道入道,因此重道入道可以被懒惰地装载.
-   **到处跑.** 节点.js `^20.19.0 || >=22.12.0`, Bun, Deno 和 evergreen 浏览器, 都在CI测试.
-   **在 TypeScript 中写入 .** 与包打出船来,每一次拉出请求都会与上回放出相比被检查,所以公众API从不会默默地改变.
-   **对照官方规则验证.** 每个验证员都引用其执行的规格,定律或数据集,测试套件经过了突变测试,而不仅仅是覆盖.
-   **英文和葡萄牙文文件**,带有 `llms.txt` 给AI助手的.

## 安装

```bash
npm install @brazilian-utils/brazilian-utils
```

同一软件包与 `yarn add`, (中文(简体) ), `pnpm add` 财务报告和审定财务报表 `bun add`在平地上 `<script>` 标记它暴露全球 `BrazilianUtils`数字 :

```html
<script src="https://unpkg.com/@brazilian-utils/brazilian-utils/dist/brazilian-utils.umd.cjs"></script>
```

### 运行时间支持

支持范围是 `engines` 输入 `package.json`; 下行每行运行于 [测试工作流程](https://github.com/brazilian-utils/javascript/actions/workflows/tests.yml?query=branch%3Amain) 每一个拉请求.

| 运行时间 | 支助 | 测试于CI |
| --- | --- | --- |
| 节点.js | `^20.19.0 || >=22.12.0` | 第20、22、24、26条 |
| 阿宝 | 最新消息 | 最新消息 |
| 德诺 | 2.x 数据 | 2.x 数据 |
| 浏览器 | 常绿 | 克罗姆、火狐、边缘、萨法里 |

## 使用量

导入所需的函数 :

```javascript
import { isValidCpf } from "@brazilian-utils/brazilian-utils";

isValidCpf("1232454233345"); // false
```

这个 [水电费参考](https://brazilian-utils.com.br/utilities) 列出按家庭分类的每个功能,以及其选项和实例.

-   使用AI编码助理? 文件在上下文7上索引为 [`/brazilian-utils/javascript`](https://context7.com/brazilian-utils/javascript),以及 [页:1](https://brazilian-utils.com.br/llms.txt) 列出用于其他工具的每个工具。 见 [AI 助理人员](https://brazilian-utils.com.br/getting-started?id=ai-assistants)。 。 。 .
-   包裹可树摇. 每个管子也作为自己的子路径(如. `@brazilian-utils/brazilian-utils/get-cities`这样你就可以懒惰地装上几个重的 见 [套装大小](https://brazilian-utils.com.br/getting-started?id=bundle-size)。 。 。 .

## 发展

此寄存器使用 Vite+ 作为本地工具链; 它被安装为依赖, 所以没有 将在24号节点之后全球安装(版本为 `.nvmrc`,工具链需要的 库本身支持节点.js `^20.19.0 || >=22.12.0`) (中文(简体) ).

```bash
npm install
npm run check
npm test
npm run build
```

[捐款额](https://github.com/brazilian-utils/javascript/blob/main/CONTRIBUTING.md) 列出每个脚本和检查 牵引请求通过.

发布注释通过 [GitHub 发布](https://github.com/brazilian-utils/javascript/releases)。 。 。 .

## 贡献者

我们的"谢谢"是给这些优秀的人的[emoji 密钥](https://github.com/kentcdodds/all-contributors#emoji-key):

<table><tbody><tr><td align="center"><a href="https://github.com/hyanmandian" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/5044101?v=3?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>希安·曼地语Name</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=hyanmandian" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=hyanmandian" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-ideas-hyanmandian" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=hyanmandian" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/lucassveloso" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/4587602?v=3?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>卢卡斯·维洛索</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=lucassveloso" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=lucassveloso" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-ideas-lucassveloso" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=lucassveloso" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/andreoav" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/508827?v=3?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>安德烈奥·维埃拉</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=andreoav" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=andreoav" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-ideas-andreoav" title="Ideas, Planning, &amp; Feedback" rel="nofollow noopener noreferrer">🤔</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-tool-andreoav" title="Tools" rel="nofollow noopener noreferrer">🔧</a></td><td align="center"><a href="https://github.com/matAlmeida" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars3.githubusercontent.com/u/12724212?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>马修斯·阿尔梅达</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=matAlmeida" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=matAlmeida" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=matAlmeida" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/FernandoRogelin" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/32275453?s=400&amp;u=55d9685df8b4dc14169719993d4997b2a9adda61&amp;v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>费尔南多·罗热林</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=fernandorogelin" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=fernandorogelin" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=fernandorogelin" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/rodineijf" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/24531420?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>罗地涅伊夫</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=rodineijf" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=rodineijf" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=rodineijf" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://twitter.com/elaurent_" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/10627086?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>爱默生·洛朗蒂诺</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=emersonlaurentino" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=emersonlaurentino" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=emersonlaurentino" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td></tr><tr><td align="center"><a href="https://github.com/Leonardo18" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/14338574?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>莱昂纳多·杜特拉</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=Leonardo18" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=Leonardo18" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=Leonardo18" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://victormagalhaes.codes/" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars3.githubusercontent.com/u/357835?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>维克多·马加莱</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=vhfmag" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-tool-vhfmag" title="Tools" rel="nofollow noopener noreferrer">🔧</a></td><td align="center"><a href="https://github.com/fxamauri" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars0.githubusercontent.com/u/33326988?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>阿毛里·迪亚斯</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=fxamauri" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-tool-fxamauri" title="Tools" rel="nofollow noopener noreferrer">🔧</a></td><td align="center"><a href="https://github.com/felipediogo" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars3.githubusercontent.com/u/26486135?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>费利佩·迪奥戈</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=felipediogo" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=felipediogo" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/alanraso" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars0.githubusercontent.com/u/6992731?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>艾伦·拉索</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=alanraso" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=alanraso" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://ftfetter.wordpress.com/" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars0.githubusercontent.com/u/18450242?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>费利佩脚</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=ftfetter" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td><td align="center"><a href="https://github.com/rfoel" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars3.githubusercontent.com/u/19496473?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>拉斐尔·佛朗哥</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=rfoel" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=rfoel" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td></tr><tr><td align="center"><a href="https://github.com/pezzetti" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars1.githubusercontent.com/u/6005103?s=460&amp;v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>拉斐尔·佩泽蒂</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=pezzetti" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=pezzetti" title="Tests" rel="nofollow noopener noreferrer">⚠️</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=pezzetti" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td><td align="center"><a href="https://github.com/arfurlaneto" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars0.githubusercontent.com/u/3330854?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>安东尼奥·罗伯托·富拉内托</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=arfurlaneto" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=arfurlaneto" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=arfurlaneto" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://www.linkedin.com/in/felipe-nolleto-nascimento-a2a23788/" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/2437673?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>费利佩·诺莱托·纳西门托</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=nolleto" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=nolleto" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=nolleto" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="http://linkedin.com/in/saulojoab" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars2.githubusercontent.com/u/37988252?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>索罗·约布</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=saulojoab" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td><td align="center"><a href="http://fb.com/arantespp" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars0.githubusercontent.com/u/16626980?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>佩德罗·阿兰特斯</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=arantespp" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=arantespp" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=arantespp" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="http://fb.com/silvioclecio" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars0.githubusercontent.com/u/1456829?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>西尔维奥·克莱西奥</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=silvioprog" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=silvioprog" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=silvioprog" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/saculbr" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars1.githubusercontent.com/u/4311885?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>卢卡斯·纳西门托</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=saculbr" title="Code" rel="nofollow noopener noreferrer">💻</a></td></tr><tr><td align="center"><a href="https://lincon.dev/" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars3.githubusercontent.com/u/5117676?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>林康·克苏诺基</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=linconkusunoki" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=linconkusunoki" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=linconkusunoki" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/marceloabk" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars3.githubusercontent.com/u/11621153?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>马塞洛·克里斯蒂亚诺</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=marceloabk" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=marceloabk" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=marceloabk" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/tbfreitas" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars.githubusercontent.com/u/8523621?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>塔西西奥·巴蒂斯塔·德弗赖塔斯</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=tbfreitas" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td><td align="center"><a href="https://www.linkedin.com/in/lucas-carrias-474081195/" rel="nofollow noopener noreferrer"><img alt="" src="https://avatars.githubusercontent.com/u/24925816?v=4?s=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>卢卡斯·卡里亚斯</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=LucasCarrias" title="Documentation" rel="nofollow noopener noreferrer">📖</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=LucasCarrias" title="Tests" rel="nofollow noopener noreferrer">⚠️</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=LucasCarrias" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://npmcn.com/package/%40brazilian-utils/brazilian-utils/#readme-tool-LucasCarrias" title="Tools" rel="nofollow noopener noreferrer">🔧</a></td><td align="center"><a href="https://github.com/matheusandre1" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/matheusandre1.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>马修斯·安德烈</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=matheusandre1" title="Documentation" rel="nofollow noopener noreferrer">📖</a></td><td align="center"><a href="https://github.com/Henrique-volponi" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/Henrique-volponi.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>恩里克·沃尔波尼</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=Henrique-volponi" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/lindsay-qive" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/lindsay-qive.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>林赛·费雷拉</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=lindsay-qive" title="Code" rel="nofollow noopener noreferrer">💻</a></td></tr><tr><td align="center"><a href="https://github.com/vicentevendramin" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/vicentevendramin.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>维森特·范德拉明</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=vicentevendramin" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/joaopedroassad" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/joaopedroassad.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>乔·阿萨德</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=joaopedroassad" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=joaopedroassad" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td align="center"><a href="https://github.com/JanderSilv" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/JanderSilv.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>扬德·席尔瓦</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=JanderSilv" title="Code" rel="nofollow noopener noreferrer">💻</a></td><td align="center"><a href="https://github.com/kwy404" rel="nofollow noopener noreferrer"><img alt="" src="https://github.com/kwy404.png?size=100" width="100px;" loading="lazy" decoding="async" referrerpolicy="no-referrer"><br><sub><b>千维404</b></sub></a><br><a href="https://github.com/brazilian-utils/javascript/commits?author=kwy404" title="Code" rel="nofollow noopener noreferrer">💻</a> <a href="https://github.com/brazilian-utils/javascript/commits?author=kwy404" title="Tests" rel="nofollow noopener noreferrer">⚠️</a></td><td></td><td></td><td></td></tr></tbody></table>

本项目遵循 [全部贡献者](https://github.com/kentcdodds/all-contributors) 规格。 欢迎任何捐助!

## 许可证

[麻省理工学院](https://github.com/brazilian-utils/javascript/blob/main/LICENSE)

## 常见问题

### @brazilian-utils/brazilian-utils 是什么？

巴西数据的零依赖性、可树动类型Script公用事业:验证、格式、剖析和生成CPF、CNPJ、CEP、Boleto、Pix、电话、节假日等\.

### 如何安装 @brazilian-utils/brazilian-utils？

在项目目录运行 npm install @brazilian-utils/brazilian-utils，或使用 pnpm add / yarn add / bun add。

### @brazilian-utils/brazilian-utils 支持 TypeScript 吗？

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

### @brazilian-utils/brazilian-utils 支持 ESM 还是 CommonJS？

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

### @brazilian-utils/brazilian-utils 需要什么版本的 Node\.js？

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

### @brazilian-utils/brazilian-utils 可以商用吗？

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

### @brazilian-utils/brazilian-utils 的下载量有多少？

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

### @brazilian-utils/brazilian-utils 还在维护吗？

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