Humanizer 2.14.1 的 EnglishArticles 枚举：定义英语定冠词与不定冠词的语言标记及 3.0 迁移影响

EnglishArticles 是 Humanizer 2.14.1 中一个简洁的枚举类型，用于表示英语的定冠词（The）与不定冠词（A、An）。它常与 EnglishArticle 排序辅助类、枚举属性读取等场景搭配，并在迁移到 Humanizer 3.0 时被移除，需要以枚举无关逻辑替代。读完本文，你将掌握该枚举的字段定义、典型应用场景、源码中的真实调用方式，以及从 2.x 平滑迁移到 3.x 的注意事项。

枚举定义总览

在 Humanizer 2.14.1 的 API 参考文档（Humanizer.EnglishArticles.md）中，该枚举被描述为：

Definite and Indefinite English Articles

即"英语定冠词与不定冠词"。它共包含三个字段：

字段名	数值	说明
A	0	不定冠词 a（用于辅音音素开头的单词前）
An	1	不定冠词 an（用于元音音素开头的单词前）
The	2	定冠词 the

从数值上看，A = 0、An = 1、The = 2，三个成员依次递增，未显式赋值，因此其底层存储值与声明顺序一致。

在项目中的实际使用场景

虽然该枚举本身的 API 文档非常简短，但它在 Humanizer 2.14.1 的整个英文冠词处理体系中扮演着"语言标记"的角色。与它紧密相关的核心工具类是 EnglishArticle，该类位于 src/Humanizer/ArticlePrefixSort.cs，提供了两个静态方法，专门用于忽略冠词前缀进行字符串排序：

• AppendArticlePrefix(string[] items)：检测字符串开头的冠词（The / the / A / a / An / an），将其从头部移除并追加到字符串末尾，然后对整个数组进行排序；
• PrependArticleSuffix(string[] appended)：把上面追加到末尾的冠词重新还原到字符串开头，恢复原始可读形式。

典型的使用流程是：先 AppendArticlePrefix 排序，再 PrependArticleSuffix 还原，从而让 "The Theater"、"The apple"、"Ant"、"Bear"、"Fox" 这类列表按忽略冠词后的主词排序。

从源码看，TryGetArticlePrefixLength 方法逐字检测前缀是否为 The（长度 3）、the（长度 3）、a（长度 1）、A（长度 1）、An（长度 2）、an（长度 2），并通过 IsArticle 校验冠词后必须是空格且下一个字符是合法的 Unicode 单词字符（字母、数字、连接符、零宽连接符 \u200C/\u200D 等），从而避免误把 "Theory"、"An!" 这类词当作冠词开头处理。测试用例 ArticlePrefixSortTests.cs 也验证了这些边界行为，例如：

• "The Éclair" → "Éclair The"
• "An Æon" → "Æon An"
• "The 7th Seal" → "7th Seal The"
• "Theory" → "Theory"（保持不变，不误判）
• "The\tTheater" → "The\tTheater"（制表符分隔不被识别为冠词前缀）

此外，仓库还提供了对应的基准测试 EnglishArticleBenchmarks.cs，用于衡量 AppendArticlePrefix 与 PrependArticleSuffix 在典型输入数组上的性能表现。

EnglishArticles 与枚举人性化（EnumHumanize）的关系

Humanizer 的 EnumHumanizeExtensions 可以把枚举成员转换为可读文本。在 2.14.1 版本中，EnglishArticles 这类"语言标记枚举"的价值在于：当应用需要根据冠词类型做分支处理（例如按 A / An / The 决定显示文案或排序规则）时，可以用 EnglishArticles.The 等成员作为强类型的状态标记，配合 EnglishArticle 类完成冠词感知的排序，而不是硬编码字符串常量。

从 API 索引文档（Humanizer.md）可以看到，EnglishArticles 在 2.14.1 的公开 API 列表中确实被收录，说明它属于该版本对外公开的类型之一。

迁移到 Humanizer 3.0 的注意事项

EnglishArticles 在 Humanizer 3.0 中已被移除。在官方迁移指南 version-3-migration.mdx 的"Replace removed APIs"一节中明确列出了：

| EnglishArticles | Replace the enum-dependent logic in the application. |

即：如果应用代码中依赖 EnglishArticles 枚举，需要将基于该枚举的分支逻辑替换为枚举无关的实现。实际迁移时，可以这样做：

1. 直接使用字符串字面量或自定义常量：在需要判断冠词的位置，用 "a"、"an"、"the"（或自定义常量类）替代 EnglishArticles.A / .An / .The；
2. 复用 EnglishArticle 排序能力：若原本用该枚举驱动排序逻辑，3.x 中继续使用 EnglishArticle 的 AppendArticlePrefix / PrependArticleSuffix 方法即可，这两个方法的实现并不依赖该枚举；
3. 借助分析器迁移：迁移指南建议先安装 Humanizer 3.0.10，再使用 HUMANIZER001 分析器（见 website/docs/analyzer/index.mdx）自动替换旧命名空间与已废弃类型引用，随后手工修复剩余的编译器错误。

迁移指南同时提醒：Humanizer 3 的目标框架资产为 netstandard2.0、net48、net8.0、net10.0，2.x 时代的 netstandard1.0 与 net6.0 资产已移除；因此升级前应确认项目的目标框架与 NuGet 还原工具链版本。

小结

EnglishArticles 是 Humanizer 2.14.1 公开 API 中一个轻量但定位明确的枚举：

• 三个成员 A、An、The 分别对应英语的两个不定冠词与一个定冠词，数值依次为 0、1、2；
• 它常与冠词感知排序工具 EnglishArticle 配合使用，实现"忽略冠词前缀排序"的图书、影音、商品列表场景；
• 在迁移到 Humanizer 3.0 时，该枚举被移除，需以枚举无关的逻辑替代，而排序能力本身仍由 EnglishArticle 类继续提供。

如果项目仍停留在 2.14.1，请按上述字段定义与使用方式维护代码；如果计划升级到 3.x，请优先处理 EnglishArticles 的替换项，再借助 HUMANIZER001 分析器完成其余 API 迁移。