深入理解 PEP 750：Python 全新 Template String（t-string）详解

Template String（t-string）详解

PEP 750 引入了一种全新的字符串处理方式–Template String（模板字符串，简称 t-string），旨在为开发者带来更灵活、更安全的字符串插值与处理能力。t-string 是对传统 f-string 的泛化，语法上仅需将前缀 f 替换为 t，但其行为有本质区别：t-string 并不直接生成字符串（str），而是生成一个新的不可变类型 Template，开发者可在字符串最终合成前，访问静态文本部分和所有插值表达式及其值，实现自定义处理、校验和转换。

t-string 的基本用法如下：

from string.templatelib import Template

name = "World"
template = t"Hello {name}"
assert isinstance(template, Template)

t-string 支持与 f-string 相同的插值表达式、转换标志（如 !r、!s、!a）和格式化说明（如 :.2f），并可嵌套使用。t-string 还支持原始字符串（rt 或 tr 前缀），方便处理包含转义字符的场景。

Template String 的使用场景

t-string 设计之初就为了解决 f-string 在安全性和灵活性上的局限，典型应用场景包括：

• 安全的 Web 模板渲染：在生成 HTML、SQL 等内容时，t-string 允许开发者在插值前对变量做转义、过滤，有效防止 XSS、SQL 注入等安全问题。
• 领域特定语言（DSL）实现：t-string 可作为构建自定义模板引擎、配置语言的基础，灵活处理模板内容和插值。
• 结构化日志：结合 t-string，可以轻松实现结构化日志，将消息和插值变量分别处理，便于日志聚合与分析。
• 复杂字符串处理：如国际化、格式转换、上下文敏感插值等，t-string 提供了比 f-string 更强的可编程性。
• 代码生成与分析：可用于生成代码片段、动态表达式等场景，开发者可在插值前对表达式做静态分析或转换。

t-string 与传统 f-string 的区别

特性	f-string	t-string (PEP 750)
前缀	f	t
结果类型	str	Template
可访问插值前的内容	否	是（可访问字符串与插值）
插值处理时机	立即插值并合成字符串	立即求值但不合成字符串
可自定义处理	受限	完全可自定义
典型用途	简单插值、格式化	安全处理、模板引擎、DSL
是否可嵌套	否	是

t-string 的最大优势在于分离了模板结构与插值值的合成过程，开发者可以在插值被合成前，访问每个插值的表达式、值、格式说明等信息，实现比 f-string 更细粒度的控制。

代码示例

基本用法

from string.templatelib import Template

name = "World"
template = t"Hello {name}!"
print(template.strings)        # ("Hello ", "!")
print(template.values)         # ("World",)

自定义处理：将插值部分转为大写

from string.templatelib import Template, Interpolation

def upper_interpolations(template: Template) -> str:
    parts = []
    for item in template:
        if isinstance(item, Interpolation):
            parts.append(str(item.value).upper())
        else:
            parts.append(item)
    return "".join(parts)

name = "world"
print(upper_interpolations(t"hello {name}!"))  # hello WORLD!

实现 f-string 行为

from string.templatelib import Template, Interpolation

def f(template: Template) -> str:
    parts = []
    for item in template:
        if isinstance(item, str):
            parts.append(item)
        elif isinstance(item, Interpolation):
            value = item.value
            if item.conversion == "r":
                value = repr(value)
            elif item.conversion == "s":
                value = str(value)
            elif item.conversion == "a":
                value = ascii(value)
            value = format(value, item.format_spec)
            parts.append(value)
    return "".join(parts)

name = "World"
value = 42
templated = t"Hello {name!r}, value: {value:.2f}"
print(f(templated))  # Hello 'World', value: 42.00

结构化日志示例

import json
from string.templatelib import Template, Interpolation

class TemplateMessage:
    def __init__(self, template: Template):
        self.template = template

    @property
    def message(self) -> str:
        return f(self.template)

    @property
    def values(self):
        return {item.expression: item.value for item in self.template if isinstance(item, Interpolation)}

    def __str__(self):
        return f"{self.message} >>> {json.dumps(self.values)}"

action, amount, item = "traded", 42, "shrubs"
print(TemplateMessage(t"User {action}: {amount:.2f} {item}"))
# 输出: User traded: 42.00 shrubs >>> {"action": "traded", "amount": 42, "item": "shrubs"}

支持的 Python 版本

t-string（PEP 750）已被正式接受，将在 Python 3.14（预计 2025 年末发布）中作为标准特性引入。相关类型 Template 和 Interpolation 位于标准库 string.templatelib 模块。

总结

PEP 750 的 t-string 为 Python 字符串处理带来了革命性的变革。它不仅继承了 f-string 的简洁语法，还提供了对模板结构与插值的完全访问能力，使开发者能够在字符串最终生成前进行任意自定义处理。这为安全渲染、领域特定语言、结构化日志等高级场景提供了强大支持。随着 Python 3.14 的发布，t-string 有望成为现代 Python 开发中不可或缺的字符串处理利器。