# @art-suite/art-core-ts-string-case 中文文档

规范地址：https://npmcn.com/package/%40art-suite/art-core-ts-string-case/

版本：0\.2\.2
npm 元数据更新时间：2026-06-19T10:23:17.875Z
中文译文更新时间：2026-11-06T20:36:43.344Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：20.3 kB，9 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2025-05-12T09:03:03.496Z
- 最新版本发布：2026-06-19T10:23:17.752Z
- 近 30 天下载量：3248（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：19（近 12 个月 6 个）

## 中文简介

一个用于将字符串转换成不同"代码单词"大小写的TypeScript字符串库:骆驼Case,蛇 case,kebab-case,PascalCase等.

## 安装

```sh
npm install @art-suite/art-core-ts-string-case
```

也可以使用：`pnpm add @art-suite/art-core-ts-string-case`、`yarn add @art-suite/art-core-ts-string-case`、`bun add @art-suite/art-core-ts-string-case`

## README

# @ art- suite/ art- core- ts- string- case (中文(简体) )

在编程中所有常见的字符串大小写格式之间无所不包,无所不失的转换.

## 为什么是这个模块?

**为什么:** 在编程中,有几种没有空格的表达单词的共同方式——骆驼Case,蛇 case,破折号等. 它们之间的转换经常是需要的,但处理边缘案件(特别是缩略语)很棘手,容易出错。 如何将缩写表示为"代码单词"没有明确的标准,大多数库在格式之间转换时会丢失信息.

**如何解释:** 这个库有一个关键假设:缩写被当做是单词. 例如"HTML"就作为"Html"来对待,以"代码"为用. 这样就可以在所有支持的格式之间实现无损失的圆通转换——这样你就可以在不丢失字词边界或缩略语信息的情况下,总是可以前后转换.

**何谓:** 在骆驼Case、PascalCase、蛇 case、UPPER SNAKE CASE、破折号、Capitized-Dash-Case之间转换的一套综合功能,以及更多的功能,所有功能都具有强力处理缩写.

## 安装和使用示例( 需要)

用 npm 安装 :

```sh
npm install @art-suite/art-core-ts-string-case
```

基本用途:

```ts
import {
  getCodeWords,
  lowerCamelCase,
  upperCamelCase,
  snakeCase,
  upperSnakeCase,
  dashCase,
  capitalizedDashCase,
  pascalCase,
  kebabCase,
  constantCase,
  camelCase,
} from "@art-suite/art-core-ts-string-case";

getCodeWords("toHTML"); // ["to", "Html"]
lowerCamelCase("to HTML"); // "toHtml"
upperCamelCase("to HTML"); // "ToHtml"
snakeCase("to HTML"); // "to_html"
upperSnakeCase("to HTML"); // "TO_HTML"
dashCase("to HTML"); // "to-html"
capitalizedDashCase("to HTML"); // "To-Html"

// Aliases
pascalCase("to HTML"); // "ToHtml"
kebabCase("to HTML"); // "to-html"
constantCase("to HTML"); // "TO_HTML"
camelCase("to HTML"); // "toHtml"

// All converters accept an optional second parameter: the joiner string
upperCamelCase("to HTML", " "); // "To Html"
snakeCase("to HTML", "--"); // "to--html"
```

## 职能概览

### 代码词提取

-   `getCodeWords(str)` ——从任意字符串中取出一系列代码单词,将缩略语作为单词处理(如"toHTML")- `["to", "Html"]`) (中文(简体) ).

### 大小写转换函数

所有转换器接受可选的第二个参数, `joiner`,这是在每个单词之间插入的字符串(默认值因转换器而异).

-   `lowerCamelCase(str, joiner?)` ——转换为下卡梅尔Case.
-   `upperCamelCase(str, joiner?)` ——转换为上卡梅尔Case(PascalCase).
-   `snakeCase(str, joiner?)` – 转换为蛇 case.
-   `upperSnakeCase(str, joiner?)` 转换为 UPPER SNAKE CASE .
-   `dashCase(str, joiner?)` - 转换为破折号.
-   `capitalizedDashCase(str, joiner?)` ——转换为资本化-Dash-Case.
-   `pascalCase(str, joiner?)` -别提了 `upperCamelCase`。 。 。 .
-   `kebabCase(str, joiner?)` -别提了 `dashCase`。 。 。 .
-   `constantCase(str, joiner?)` -别提了 `upperSnakeCase`。 。 。 .
-   `camelCase(str, joiner?)` -别提了 `lowerCamelCase`。 。 。 .

### 单词大小写工具

-   `lowerCase(str)`

## 常见问题

### @art-suite/art-core-ts-string-case 是什么？

一个用于将字符串转换成不同"代码单词"大小写的TypeScript字符串库:骆驼Case,蛇 case,kebab-case,PascalCase等\.

### 如何安装 @art-suite/art-core-ts-string-case？

在项目目录运行 npm install @art-suite/art-core-ts-string-case，或使用 pnpm add / yarn add / bun add。

### @art-suite/art-core-ts-string-case 支持 TypeScript 吗？

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

### @art-suite/art-core-ts-string-case 支持 ESM 还是 CommonJS？

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

### @art-suite/art-core-ts-string-case 可以商用吗？

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

### @art-suite/art-core-ts-string-case 的下载量有多少？

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

### @art-suite/art-core-ts-string-case 还在维护吗？

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