数量英文完整示例：3个实战项目攻克翻译难题

看了一堆教程还是不会写项目？这是很多刚接触编程或自然语言处理（NLP）的朋友最真实的写照。你背熟了单词，理解了语法，但一旦要把“3个苹果”这种带有数量关系的英文文本转换成结构化数据，或者在电商系统中准确解析商品描述，瞬间就卡壳了。别慌，问题不在于你不够努力，而在于缺少一个完整示例作为骨架。

今天不聊虚的，直接上干货。我们将通过三个由浅入深的实战项目，彻底搞懂“数量英文”在工程中的处理逻辑。从最基础的字符串解析，到结合正则表达式的自动化清洗，再到利用Python库进行半结构化提取，每一步都给你最扎实的代码实现。目标只有一个：让你看完就能跑，跑完就能用。

项目目标：定义“数量英文”的工程边界

在动手之前，我们必须明确：在编程语境下，“数量英文”到底指什么？它不仅仅是“one, two, three”这些单词，更包括数字与英文量词的复杂组合，如“two hundred units”、“a dozen eggs”甚至“3.5 kilograms”。

我们的核心目标不是做一个完美的翻译机，而是构建一个能够稳定提取文本中“数量+单位”结构的小工具。这在实际开发中极为常见：

电商订单解析：用户输入“2箱牛奶，5瓶水”，后端需要拆解为 {product: 'milk', qty: 2, unit: 'box'}。
日志清洗：从服务器日志中提取“Allocated 4 GB memory”中的资源配额。
库存管理：处理供应商传来的非标准格式库存报表。

这三个场景共同点在于：数据源是自然语言或半结构化文本，但我们需要的是机器可读的数值和单位。接下来的三个项目，将分别对应这三个复杂度的场景。

目录结构：搭建可复用的工程骨架

很多新手喜欢把所有代码扔进一个 main.py 里，这在学习阶段没问题，但一旦进入实战，维护噩梦就开始了。我们采用标准的模块化结构，确保代码可复用、易测试。

创建如下目录结构：

quantity_english/
├── data/
│   └── test_samples.txt      # 存放测试用的原始文本数据
├── utils/
│   ├── __init__.py
│   ├── number_parser.py      # 负责将英文单词转换为数字
│   └── unit_mapper.py        # 负责单位词的同义词映射
├── core/
│   ├── __init__.py
│   └── extractor.py          # 核心提取逻辑，调用utils模块
├── main.py                    # 入口文件，运行三个项目
└── tests/└── test_extractor.py     # 单元测试

这种结构的好处是：职责分离。number_parser 只关心“two”变成2，“thirty”变成30；unit_mapper 只关心“kg”、“kilogram”、“kgs”都映射到标准的“kilogram”。当需求变更时，比如增加新的单位支持，你只需要修改 unit_mapper.py，而不需要动核心提取逻辑。

核心代码实现：从正则到语义映射

这是最关键的部分。我们将分三步走，逐步构建完整示例。

第一步：基础正则提取（项目一）

最直观的方法是使用正则表达式匹配“数字+空格+单词”的模式。虽然简单，但能跑通90%的简单场景。

import redef extract_basic_quantities(text):"""基础提取：匹配 [数字] [英文单词] 的组合"""# 匹配模式：一个或多个数字，后跟一个空格，再跟一个或多个字母pattern = r'(\d+)\s+([a-zA-Z]+)'matches = re.findall(pattern, text)results = []for num_str, unit_str in matches:# 简单清洗：将单位转为小写unit = unit_str.lower()results.append({'quantity': int(num_str),'unit': unit})return results# 测试用例
sample_1 = "I have 5 apples and 3 oranges."
print(extract_basic_quantities(sample_1))
# 输出: [{'quantity': 5, 'unit': 'apples'}, {'quantity': 3, 'unit': 'oranges'}]

避坑指南：这个正则有个致命弱点，它无法处理“two apples”这种纯英文数字，也无法处理“3.5 kg”这种小数。但在处理机器生成的、格式相对固定的日志时，它足够快且轻量。

第二步：英文数字转数值（项目二）

当用户输入“two hundred boxes”时，上面的代码就失效了。我们需要一个模块将英文单词转换为阿拉伯数字。这里我们不引入庞大的NLP库，而是手写一个轻量级的映射逻辑，既高效又可控。

在 utils/number_parser.py 中：

class NumberParser:def __init__(self):# 基础数字映射self.number_map = {'one': 1, 'two': 2, 'three': 3, 'four': 4, 'five': 5,'six': 6, 'seven': 7, 'eight': 8, 'nine': 9, 'ten': 10,'eleven': 11, 'twelve': 12, 'thirteen': 13, 'fourteen': 14,'fifteen': 15, 'sixteen': 16, 'seventeen': 17, 'eighteen': 18,'nineteen': 19, 'twenty': 20, 'thirty': 30, 'forty': 40,'fifty': 50, 'sixty': 60, 'seventy': 70, 'eighty': 80, 'ninety': 90,'hundred': 100, 'thousand': 1000}self.current_value = 0self.total_value = 0def parse_english_number(self, text):"""解析英文数字文本，如 'two hundred and five' -> 205"""self.current_value = 0self.total_value = 0words = text.lower().replace(' and ', ' ').split()for word in words:if word in self.number_map:value = self.number_map[word]if value < 100:self.current_value += valueelif value == 100:if self.current_value == 0:self.current_value = 1 # 处理 'hundred'self.current_value *= valueelse: # thousandif self.current_value == 0:self.current_value = 1self.current_value *= valueself.total_value += self.current_valueself.current_value = 0# 累加剩余的部分self.total_value += self.current_valuereturn self.total_value# 测试
parser = NumberParser()
print(parser.parse_english_number("two hundred")) # 输出: 200
print(parser.parse_english_number("fifty"))       # 输出: 50

注意：这个实现是简化的，适用于常见场景。在生产环境中，如果涉及极其复杂的数字表述，建议参考 inflect 或 word2number 等成熟库，但理解底层逻辑对你调试问题至关重要。

第三步：单位标准化映射（项目三）

“kg”、“kgs”、“kilogram”、“kilograms”在业务上是同一个概念。如果数据库里存的是“kg”，而用户输入“kilograms”，直接匹配会失败。我们需要一个标准化层。

在 utils/unit_mapper.py 中：

class UnitMapper:def __init__(self):# 定义同义词组，第一个值为标准名self.synonyms = {'kg': ['kg', 'kgs', 'kilogram', 'kilograms', 'kilos'],'g': ['g', 'gs', 'gram', 'grams'],'box': ['box', 'boxes', 'carton', 'cartons'],'unit': ['unit', 'units', 'piece', 'pieces', 'pcs']}# 构建反向映射：{同义词: 标准名}self.reverse_map = {}for std, syns in self.synonyms.items():for syn in syns:self.reverse_map[syn] = stddef normalize_unit(self, unit_str):"""将任意单位字符串转换为标准单位如果无法识别，返回原字符串的小写形式"""if not unit_str:return Noneunit_lower = unit_str.lower()return self.reverse_map.get(unit_lower, unit_lower)# 测试
mapper = UnitMapper()
print(mapper.normalize_unit("Kilograms")) # 输出: kg
print(mapper.normalize_unit("Boxes"))     # 输出: box
print(mapper.normalize_unit("Unknown"))   # 输出: unknown

运行与测试：验证你的完整示例

现在，我们将所有模块整合到 core/extractor.py 中，形成一个完整的提取器。

import re
import sys
sys.path.append('..') # 确保能导入utilsfrom utils.number_parser import NumberParser
from utils.unit_mapper import UnitMapperclass QuantityExtractor:def __init__(self):self.num_parser = NumberParser()self.unit_mapper = UnitMapper()# 增强正则：匹配 [数字或英文数字] [单位]# 这里简化处理，主要匹配纯数字或常见的英文数字组合# 实际生产中，正则可能更复杂，需要预处理self.pattern = r'((?:\d+\.?\d*)|(?:\w+\s+)?(?:\w+\s+)?(?:\w+))\s+([a-zA-Z]+)'def extract(self, text):matches = re.findall(self.pattern, text)results = []for num_part, unit_part in matches:# 尝试解析数字qty = self._parse_quantity(num_part)if qty is None:continue# 标准化单位std_unit = self.unit_mapper.normalize_unit(unit_part)results.append({'quantity': qty,'unit': std_unit,'raw': f"{num_part} {unit_part}"})return resultsdef _parse_quantity(self, text):text = text.strip().lower()# 1. 尝试直接转int/floattry:if '.' in text:return float(text)return int(text)except ValueError:pass# 2. 尝试英文解析# 简单启发式：如果包含已知数字单词，则尝试解析if any(word in text for word in self.num_parser.number_map):return self.num_parser.parse_english_number(text)return None# 主程序入口
if __name__ == "__main__":extractor = QuantityExtractor()test_cases = ["Order 5 boxes of milk","I need two hundred eggs","Weight is 3.5 kilograms","Send 10 units immediately"]for case in test_cases:print(f"Input: {case}")result = extractor.extract(case)print(f"Result: {result}\n")

运行结果预期：对于 "I need two hundred eggs"，程序会先尝试转int失败，然后调用 NumberParser 解析出 200，再调用 UnitMapper 将 eggs 映射（假设未定义则保留原样，或需补充 egg 到映射表）。

测试建议：不要只测快乐路径。一定要测试边界情况：

全大写输入："FIVE BOXES"
多余空格："5 boxes"
无单位输入："5"
干扰文本："I love apples. Buy 5."

优化扩展：从玩具到生产级

上述代码是一个很好的起点，但要用于生产环境，还需考虑以下几点：

性能优化：如果文本量极大（如百万级日志），每次创建 NumberParser 对象会有开销。可以将 NumberParser 设计为单例，或者将常用的英文数字映射缓存起来。
容错机制：如果正则匹配到了错误的组合怎么办？例如 "5 star rating"，这里 "star" 不是单位。需要引入一个单位白名单。只有当匹配到的单位在白名单中时，才视为有效的数量-单位对。
```
# 在 UnitMapper 中增加白名单校验
def is_valid_unit(self, unit_str):return unit_str in self.reverse_map.keys()
```
多语言支持：虽然本篇聚焦英文，但同样的架构可以扩展到中文。只需替换 NumberParser 为中文数字解析逻辑，UnitMapper 为中文单位映射即可。核心提取逻辑（正则+映射）保持不变。
数据持久化：将提取结果写入数据库或CSV文件。使用 pandas 库可以轻松将 results 列表转换为 DataFrame 并导出，便于后续分析。

权威参考：在处理英文数字和单位的标准化时，建议参考 MDN Web Docs 中关于字符串处理的API文档，以及 Unicode Standard 中关于数字字符的定义。虽然MDN主要面向Web，但其对字符串规范的处理逻辑对Python字符串操作也有很好的借鉴意义，特别是在处理Unicode字符集时。