# @gouch/to-title-case 中文文档

规范地址：https://npmcn.com/package/%40gouch/to-title-case/

版本：3\.0\.2
npm 元数据更新时间：2026-11-01T03:02:45.737Z
中文译文更新时间：2026-11-01T06:43:36.499Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：35.1 kB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2018-09-07T23:51:32.157Z
- 最新版本发布：2026-11-01T03:02:45.577Z
- 已发布版本数：6（近 12 个月 3 个）

## 中文简介

智能地将标题和标题格式化为一致的标题大小写。

## 安装

```sh
npm install @gouch/to-title-case
```

也可以使用：`pnpm add @gouch/to-title-case`、`yarn add @gouch/to-title-case`、`bun add @gouch/to-title-case`

## README

# JavaScript的Title Case

智能地将标题和标题格式化为一致的标题大小写。

## 安装

### 浏览器

每年都会有新的方式将JS添加到HTML中。一个现代的选择是：

```html
<script type="module">
  import { toTitleCase } from './to-title-case.js'

  toTitleCase('make me a title') //→ Make Me a Title
</script>
```

或者想要经典的全球氛围，你可以试试：

```html
<script src="to-title-case.cjs"></script>
<script>
  toTitleCase('make me a title') //→ Make Me a Title
</script>
```

### 节点

安装与 `npm install @gouch/to-title-case` 然后导入:

```js
import { toTitleCase } from '@gouch/to-title-case'

toTitleCase('make me a title') //→ Make Me a Title
```

## 使用

该脚本定义了该函数 `toTitleCase()`，它将标题大小写规则应用于输入字符串。为了获得最佳结果，假定输入是句子大小写或朴素标题大小写。

```js
toTitleCase('make me a title') //→ Make Me a Title
```

### 选项

小写单词列表可以替换为你自己的：

```js
toTitleCase('make me a title', { lowercase: ['me'] }) //→ Make me A Title
```

## 什么是产权案件？

标题大小写，或标题大小写，是格式化文章标题和其中的标题的惯例。它基本上相当于将每个单词大写，但有几个小写的例外，如果你错过了它们，看起来很奇怪。

大多数知名的风格指南都遵循以下原则 _动态_ 规则的变化取决于一个词在上下文中的使用方式。计算语法超出了小脚本的范围，因此该脚本遵循静态的、一致的规则。这些规则与《纽约时报》的风格指南非常吻合。

### 大写规则

1.  第一个和最后一个单词大写。对字幕也是如此。
2.  用连字符连接的短语的两端都要大写。
3.  尽可能保留专有名词和专业术语的格式。
4.  小写这些单词：
    -   冠词：a， an, the
    -   连词：and， but, if, nor, or
    -   短介词：as， at, by, en, for, in, of, on, per, to, via
    -   相对：vs., vs., v., v.
    -   借:
5.  其他都大写。

## 灵感与资源

我做这个是为了回应 [约翰·格鲁伯2008年的帖子](https://daringfireball.net/2008/05/title_case).

马特·贝尔茨认为 [一个优秀的网站](https://titlecaseconverter.com/rules/) 记录知名风格指南的不同规则。

## 常见问题解答

### 处理所有大写输入

如果您被大写输入所困扰，它 _是_ 从技术上讲，可以通过应用小写变换来强制使用它：

```js
toTitleCase('CNN REPORTS ON NASA CENTER IN HOUSTON, TX'.toLowerCase())
//→ Cnn Reports on Nasa Center in Houston, Tx
```

但在这样做之前要仔细考虑。虽然数据被大写卡住可能会令人沮丧，但将首字母缩写变成分散注意力的打字错误可能会更糟糕。

### 定义字符串方法

版本2将自身赋值为内置String对象的方法。如果你想恢复这个行为，你可以使用下面的代码：

```js
String.prototype.toTitleCase = function (options) {
  return toTitleCase(this, options)
}

'make me a title'.toTitleCase() //→ Make Me a Title
```

注意：箭头函数在这里不起作用，因为它们改变了方式 `this` 处理。

## 常见问题

### @gouch/to-title-case 是什么？

智能地将标题和标题格式化为一致的标题大小写。

### 如何安装 @gouch/to-title-case？

在项目目录运行 npm install @gouch/to-title-case，或使用 pnpm add / yarn add / bun add。

### @gouch/to-title-case 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/gouch\_\_to-title-case 是否存在。

### @gouch/to-title-case 支持 ESM 还是 CommonJS？

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

### @gouch/to-title-case 可以商用吗？

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

### @gouch/to-title-case 还在维护吗？

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