开发Python烘焙配方转换包时存储单位转换规则的推荐数据结构是什么？

方案选择建议 #

• 优先选择Python常量文件存储：如果你不需要开放自定义转换规则给终端用户，所有转换规则由包官方迭代维护，这种方式完全不需要处理文件读取、路径适配、解析异常等问题，最轻量化，性能也最优。
• 选择外部JSON/YAML文件存储：只有当你需要支持用户自定义单位、无需修改包源码就能扩展规则时，再考虑外部文件方案。

核心实现优化（内置常量版本） #

你当前的嵌套列表遍历查找是O(n)复杂度，单位多了之后效率很低，推荐用别名反向映射字典做O(1)匹配，所有规则集中维护，扩展性极强：

常量定义代码 #

# 1. 转换率表：标准单位名 -> 对应公制数值（体积单位对应毫升，重量单位对应克）
UNIT_CONVERSION = {
    "tsp": 5,
    "tbsp": 15,
    "oz": 28.35,
    "cup": 8 * 28.35,
    "pint": 2 * 8 * 28.35,
    "quart": 4 * 8 * 28.35,
    "gallon": 16 * 8 * 28.35,
    "lb": 16 * 28.35,
    "stick": 8 * 15,
    "count": 1
}

# 2. 别名映射表：所有单位别名（统一全大写）-> 对应标准单位名
UNIT_ALIAS = {
    # 茶匙
    "TSP": "tsp",
    "TSPS": "tsp",
    "TEASPOON": "tsp",
    "TEASPOONS": "tsp",
    # 汤匙
    "TBSP": "tbsp",
    "TBSPS": "tbsp",
    "TABLESPOON": "tbsp",
    "TABLESPOONS": "tbsp",
    # 杯
    "CUP": "cup",
    "CUPS": "cup",
    # 磅
    "LB": "lb",
    "LBS": "lb",
    "POUND": "lb",
    "POUNDS": "lb",
    # 盎司
    "OZ": "oz",
    "OUNCE": "oz",
    "OUNCES": "oz",
    # 黄油棒
    "STICK": "stick",
    "STICKS": "stick",
    # 计数单位
    "CT": "count",
    "COUNT": "count",
    # 加仑
    "GAL": "gallon",
    "GALLON": "gallon",
    "GALLONS": "gallon"
}

# 3. 单位类型表：标准单位名 -> 单位分类（体积/重量/计数）
UNIT_TYPE = {
    "tsp": "volume",
    "tbsp": "volume",
    "cup": "volume",
    "gallon": "volume",
    "lb": "weight",
    "oz": "weight",
    "stick": "weight",
    "count": "count"
}

转换逻辑示例 #

def convert_to_metric(value: float, raw_unit: str) -> tuple[float, str]:
    # 输入单位统一转大写后匹配别名
    processed_unit = raw_unit.strip().upper()
    if processed_unit not in UNIT_ALIAS:
        raise ValueError(f"不支持的计量单位: {raw_unit}")
    standard_unit = UNIT_ALIAS[processed_unit]
    metric_value = value * UNIT_CONVERSION[standard_unit]
    # 返回公制数值和单位类型，方便后续业务处理
    return metric_value, UNIT_TYPE[standard_unit]

扩展方式 #

后续新增单位只需要三步，完全不需要修改逻辑代码：

1. 在UNIT_CONVERSION中添加新单位的公制转换率
2. 在UNIT_ALIAS中添加新单位所有别名的映射
3. 在UNIT_TYPE中添加新单位的分类

外部文件适配方案 #

如果后续需要支持用户自定义规则，可以把上述三个字典的内容存为JSON文件，包初始化时用Python内置的json模块读取即可，核心转换逻辑不需要任何修改。

内容的提问来源于stack exchange，提问作者Tom Brady