# @foundernest/namecase 中文文档

规范地址：https://npmcn.com/package/%40foundernest/namecase/

版本：1\.0\.5
npm 元数据更新时间：2025-02-11T08:13:23.343Z
中文译文更新时间：2026-11-15T10:10:58.197Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：105 kB，13 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2020-03-11T17:02:55.277Z
- 最新版本发布：2021-06-16T09:25:02.303Z
- 近 30 天下载量：134356（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 0 个）

## 中文简介

用于确定人名资本化的全打字库. 基于tamtamchik PHP库.

## 安装

```sh
npm install @foundernest/namecase
```

也可以使用：`pnpm add @foundernest/namecase`、`yarn add @foundernest/namecase`、`bun add @foundernest/namecase`

## README

# 名称库

[![npm](https://img.shields.io/npm/v/@foundernest/namecase)](https://www.npmjs.org/package/@foundernest/namecase) [![Build Status](https://travis-ci.com/foundernest/namecase.svg?branch=master)](https://travis-ci.com/foundernest/namecase) [![Coverage Status](https://coveralls.io/repos/github/foundernest/namecase/badge.svg?branch=master)](https://coveralls.io/github/foundernest/namecase?branch=master) [![npm bundle size](https://img.shields.io/bundlephobia/min/@foundernest/namecase)](https://bundlephobia.com/result?p=@foundernest/namecase)

NameCase是全键入执行 `Lingua::EN::NameCase`,用于转换字符串的库,以适合大小写。 这有利于将非正常化的数据转换为对人类友好的数据.

## 说明

Forenames和取名常被完全存储在UPPERCASE或小写中. 此库允许您尽可能将姓名转换成正确的大小写 。 虽然fronemes和取名如果确实出现在单一字符串中,通常会单独存储,但以白空分隔,取名Case正确处理.

目前名称Case名称正确,包括下列任何一种:

```txt
Mc, Mac, al, el, ap, bat, ben, bin, binti, binte, da, de, das, dos, delle, della, di, du, del, der, den, ten, ter, la, le, lo, van and von.
```

它正确处理那些也包含阴道和连字符的名字.

## 安装

通过 npm

```bash
npm install @foundernest/namecase
```

线条

```bash
yarn add @foundernest/namecase
```

## 使用量

### 基本用途

```typescript
import { nameCase } from '@foundernest/namecase';

nameCase('KEITH');               // => Keith
nameCase('LEIGH-WILLIAMS');      // => Leigh-Williams
nameCase('MCCARTHY');            // => McCarthy
nameCase("O'CALLAGHAN");         // => O'Callaghan
nameCase('ST. JOHN');            // => St. John
nameCase('VON STREIT');          // => von Streit
nameCase('AP LLWYD DAFYDD');     // => ap Llwyd Dafydd
nameCase('HENRY VIII');          // => Henry VIII
nameCase('VAN DYKE');            // => van Dyke
```

### 预用

您可以通过调用默认选项来覆盖默认选项 `nameCase` 函数与 `EnvironmentOptions` 可选参数 :

```typescript
import { nameCase } from '@foundernest/namecase';

nameCase('macmurdo');                        // => MacMurdo
nameCase('macmurdo', { irish: false });      // => Macmurdo
```

您也可以设置所有后续呼叫的选项 :

```typescript
import { nameCase, setOptions } from '@foundernest/namecase';

nameCase('macmurdo');               // => MacMurdo
setOptions({ irish: false });
nameCase('macmurdo');               // => Macmurdo
```

或者你可以创造新的 `Environment` 有自定义选项的对象 :

```typescript
import Environment from '@foundernest/namecase';

const ncEnv = new Environment({
  lazy: false
  roman: false
});

ncEnv.nameCase('Na li');     // => Na Li
```

## 选项

-   `lazy` — 默认 : `true`。如果字符串已经混合了,懒惰选项是 `true`。 。 。 .
-   `irish` — 默认 : `true`。正确的“Mac”例外.
-   `spanish` — 默认 : `true`。正确的西班牙语组合 `y`, (中文(简体) ), `e` 或者说 `i`。 。 。 .
-   `roman` — 默认 : `true`正确的罗马数字.
-   `hebrew` — 默认 : `true`。对 `ben`, (中文(简体) ), `bat`。 。 。 .
-   `postnominal` — 默认 : `true`右后额. 譬如说. `PhD`。 。 。 .

## 不包括名后数

```typescript
import { excludePostNominals, nameCase } from '@foundernest/namecase';

nameCase('ČERNÝ MOST');         // Černý MOst
excludePostNominals('MOst');
nameCase('ČERNÝ MOST');         // Černý Most
```

## 更改日志

请看 [变化](https://npmcn.com/package/%40foundernest/namecase/CHANGELOG.md) 关于最近变化的更多信息.

## 测试

```bash
yarn test
```

## 捐款

请看 [贡献指南](https://npmcn.com/package/%40foundernest/namecase/CONTRIBUTING.md) 财务报告和审定财务报表 [行为守则](https://npmcn.com/package/%40foundernest/namecase/CODE_OF_CONDUCT.md) 详细情况.

## 鸣谢

这个库是一个端口 [前一頁 软件包](https://github.com/tamtamchik/namecase) 由尤里·特克琴科(英语:Yuri Tkachenko)出道,也是俄罗斯的港口 [Perl 图书馆](https://metacpan.org/release/BARBIE/Lingua-EN-NameCase-1.19) 并将其大部分功能归功于由马克·萨默菲尔德(英语:Mark Summerfield)制作的Perl版本. 任何错误在Typescript端口是我的错.

## 贷项

原始佩尔 `Lingua::EN::NameCase` 版本 :

-   版权: Mark Summerfield 1998-2014. 所有权利保留.
-   版权:"芭比"2014-2020. 所有权利保留.

Ruby 版本 :

-   版权: Aaron Patterson 2006. 所有权利保留.

前一頁 版本 :

-   版权由Yuri Tkachenko 2016-2020. 所有权利保留.

字迹版本 :

-   版权 [丹尼尔·塞约](https://github.com/daniseijo)

## 许可证

麻省理工学院许可证(MIT). 请看 [许可证文件](https://npmcn.com/package/%40foundernest/namecase/LICENSE) 更多信息.

## 常见问题

### @foundernest/namecase 是什么？

用于确定人名资本化的全打字库\. 基于tamtamchik PHP库\.

### 如何安装 @foundernest/namecase？

在项目目录运行 npm install @foundernest/namecase，或使用 pnpm add / yarn add / bun add。

### @foundernest/namecase 支持 TypeScript 吗？

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

### @foundernest/namecase 支持 ESM 还是 CommonJS？

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

### @foundernest/namecase 可以商用吗？

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

### @foundernest/namecase 的下载量有多少？

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

### @foundernest/namecase 还在维护吗？

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