Python str.maketrans 怎样同时替换字符并删除指定符号

如果一段文本既要把字符替换成另一种写法，又要删除若干符号，Python 不必连续调用多个 replace()。更稳妥的做法是用 str.maketrans() 先构造翻译表，再交给 str.translate() 一次处理：映射到字符串的字符会被替换，映射到 None 的字符会被删除，未命中的字符保持不变。

官方文档：https://docs.python.org/3/builtins/stdtypes.html#str.maketrans

这篇只讨论字符级规则，不把连续子串替换、正则表达式和 CSV 字段解析混在一起。

记住一个分工：maketrans() 负责把规则整理成表，translate() 负责按每个字符查表；删除不是空字符串替换，而是把目标字符映射为 None。

先把替换和删除拆成字符级规则

例如订单文本中使用了全角冒号、短横线和空格：全角冒号希望统一成半角冒号，短横线希望换成下划线，空格则直接移除。这三个动作都是“看到某个字符就决定它的去向”，适合放进同一张翻译表。

text = "订单： A-102  / 待处理"

# 字符映射到字符串表示替换，映射到 None 表示删除。
table = str.maketrans({
    "：": ":",
    "-": "_",
    " ": None,
})

# translate 不修改原字符串，而是返回转换后的新字符串。
cleaned = text.translate(table)
print(cleaned)  # 订单:A_102/待处理

这里的重点不是把三个 replace() 串起来，而是让规则集中在一个可命名、可复用的对象里。后续要增加删除制表符，或者把另一个符号改成统一字符，只需要调整映射表。

三种参数形式怎样选择

str.maketrans() 常见有三种写法，选择标准是规则来自哪里。

当替换关系整齐时，双参数写法更短；当规则需要表达删除或多字符结果时，字典写法更直观。

# from 与 to 按相同位置建立字符映射。
case_table = str.maketrans("abc", "ABC")
print("a-b-c".translate(case_table))  # A-B-C

# 第三个参数中的字符统一映射到 None，表示删除。
compact_table = str.maketrans("-", "_", " ")
print("A - B".translate(compact_table))  # A_B

# 字典可以把一个字符映射成多个字符，也可以直接删除。
symbol_table = str.maketrans({"&": " and ", "#": None})
print("A&B#".translate(symbol_table))  # A and B

translate 如何区分替换、删除和保留

translate() 会读取字符串中的字符，并用字符的 Unicode 序号去翻译表中查找。查到字符串就替换，查到 None 就删除；如果没有命中规则，字符会原样保留。因此不要把“没有出现在映射表里”理解成“删除”。

一个常见误区是把字符串值写成空串来表示删除。虽然某些场景下结果看起来相同，但使用 None 直接表达删除意图更清楚，也符合接口语义。

def normalize_code(value: str) -> str:
    # 显式保存规则，避免每次调用函数都重复拼装映射。
    table = str.maketrans({
        "　": " ",       # 全角空格统一为半角空格
        "，": ",",       # 中文逗号统一为半角逗号
        "\t": " ",      # 制表符改成一个普通空格
        "\r": None,      # 删除回车符，保留换行符的语义
    })
    return value.translate(table)

result = normalize_code("A　，B\tC\r\n")
print(result)  # A ,B C\n

这个函数仍然只负责字符转换。如果需求是“把连续空格压成一个”或“只替换完整单词”，那已经超出单字符翻译表的边界，应另行设计规则。

长度、Unicode 和复用时要注意什么

第一，使用 from/to 时先确认长度一致，否则构造翻译表会失败。第二，Python 字符串按 Unicode 字符处理，中文、全角符号和 emoji 都不是 ASCII 字符的特殊例外，应该直接把实际字符写进字典，或明确使用 ord() 得到序号。第三，翻译表如果固定不变，可以在模块级或函数外创建，避免重复创建；如果规则依赖用户配置，就在配置变化时重新生成。

# 用 ord() 明确写出 Unicode 序号，适合规则来自配置或数据文件的情况。
table = {
    ord("Ａ"): "A",  # 全角拉丁字母转为半角字母
    ord("＃"): None,  # 删除全角井号
}

print("Ａ＃42".translate(table))  # A42

不要把 str.translate() 当成子串替换器：它观察的是单个字符的映射，虽然某个字符可以映射成多个字符，但它不会根据词组上下文决定替换范围。

发布前的快速检查清单

• 替换目标是字符还是完整子串？只有前者适合直接用翻译表。
• from 和 to 是否等长？删除字符是否明确放在第三参数或字典的 None 值中？
• 没有命中翻译表的字符是否应该保留？如果不应该，需要补充规则，而不是期待它自动消失。
• 翻译表是否可以复用？固定规则放到函数外，动态规则跟随配置更新。

相关问题

str.maketrans 和 replace 有什么区别？

replace() 面向连续子串，能控制替换次数；maketrans()+translate() 面向字符级映射，适合在一次遍历中同时替换和删除多类字符。

为什么删除字符要用 None？

因为 translate() 对映射值有明确约定：字符串表示替换，None 表示删除，未命中则保留。把语义写进翻译表后，规则更容易阅读和维护。