Python 3.14 t-string 怎样保留结构化片段

如果你希望模板字符串在输出前仍然保留“哪一段是固定文本、哪一段来自表达式”，Python 3.14 的 t-string 正好解决这个问题。它和 f-string 使用相似的花括号语法，但结果不是拼接完成的 str，而是一个 string.templatelib.Template 对象；你可以在自己的代码里读取静态片段和 Interpolation，再决定如何渲染。

官方地址：https://www.python.org/downloads/release/python-31410/

这意味着 t-string 适合做结构化日志、HTML 属性、轻量 DSL 或其他需要“先分析、后输出”的场景。迁移时最重要的变化只有一句话：f-string 直接得到文本，t-string 先得到结构。

升级范围：t-string 从拼接结果变成 Template

Python 3.14 新增了模板字符串字面量。写法仍然接近 f-string，只是前缀从 f 换成了 t。在 t-string 中，表达式会被求值，但静态文本和插值不会立即合并为一个普通字符串。

from string.templatelib import Template

name = "Ada"
message = t"你好，{name}"

# t-string 保留模板结构，类型不是普通 str。
print(type(message))
print(isinstance(message, Template))

对比旧写法，f"你好，{name}" 的结果是已经完成替换的字符串；而 t"你好，{name}" 的结果可以继续被自定义处理器消费。t-string 并不会自动替你完成 HTML 转义、SQL 参数绑定或其他安全策略，这些规则仍需要由处理器明确实现。

变更表：f-string 和 t-string 的差异

因此，不能只把现有 f-string 的字母改成 t-string，然后仍然按字符串方法链继续调用。迁移前先确认调用方要的是文本还是结构；如果后续逻辑需要 lower()、字符串切片或直接写入文件，就应在明确的渲染步骤之后再得到 str。

旧代码风险：把 Template 当成已经完成的字符串

最常见的迁移风险是继续假定返回值就是 str。下面的代码故意把检查放在类型边界上：需要普通文本时先显式调用处理器，而不是对 Template 直接做字符串业务。

from string.templatelib import Template

user = "Ada"
template = t"欢迎，{user}"

# 先判断返回类型，避免把结构对象误当作最终文本。
if isinstance(template, Template):
    rendered = "".join(str(part) for part in template)
else:
    rendered = str(template)

print(rendered)

这个示例只展示最小的拼接行为。真实项目通常不应该对所有插值无差别调用 str()：日志可能需要脱敏，HTML 可能需要按文本节点和属性分别转义，SQL 则应该交给参数化接口。t-string 提供的是结构保留能力，不是某种安全输出协议。

新写法：读取 strings 和 Interpolation 的对应关系

Template.strings 是静态字符串元组，Template.interpolations 是动态插值元组，Template.values 则给出插值的值。静态片段比插值多一个，插值位于相邻静态片段之间。

from string.templatelib import Interpolation

product = "键盘"
count = 2
template = t"商品：{product}，数量：{count}"

# 逐个读取静态片段和插值，保留模板的原始结构。
for index, text in enumerate(template.strings):
    print("静态片段:", text)
    if index 

在这个模型中，strings[0] 位于第一个插值之前，strings[1] 位于第一个和第二个插值之间，最后一个静态片段位于所有插值之后。把它们按这个关系读取，就能在不丢失结构的情况下生成自己的中间表示。

新写法：用自定义处理器决定如何渲染

下面的处理器把插值值包装成带有 value 和 expression 的字典，静态文本保持原样。它不是通用模板引擎，而是一个展示“结构先保留、规则后决定”的最小实现。

from string.templatelib import Interpolation, Template

def to_parts(template: Template) -> list[dict[str, object] | str]:
    """把 Template 转成可供后续渲染的结构化片段。"""
    parts: list[dict[str, object] | str] = []

    for index, text in enumerate(template.strings):
        # 静态文本直接保留，不把它和动态值提前拼接。
        if text:
            parts.append(text)

        if index 

处理器可以把这些字典交给日志格式化器、HTML 生成器或其他领域代码。关键是由处理器决定插值值的输出方式，而不是让模板字面量替你做一个无法再拆开的字符串。

兼容注意：格式说明符和转换不再直接完成输出

t-string 仍然使用接近 f-string 的格式语法，例如 {amount:.2f} 或 {name!r}。但在 t-string 中，格式说明符和转换会被记录到 Interpolation，最终如何使用它们由处理器决定；这和 f-string 直接调用格式化协议得到结果不同。

from string.templatelib import Template

amount = 12.5
template = t"金额：{amount:.2f}"
item = template.interpolations[0]

# 不要假定 t-string 已经把格式说明符应用到最终文本。
print(item.value)
print(item.format_spec)
print(item.conversion)

# 如果业务需要普通文本，再由明确的渲染规则决定输出。
rendered = f"金额：{item.value:{item.format_spec}}"
print(rendered)

如果格式说明符中还包含嵌套替换字段，相关字段会先求值，再作为 format_spec 传给插值对象。升级检查时，应重点查找那些假设“构造模板就已经完成格式化”的代码。

回归检查：把结构保留能力放在正确边界

从 f-string 迁移到 t-string 时，可以按下面的边界判断：

• 如果调用方只需要最终文本，继续使用 f-string 往往更直接。
• 如果调用方需要区分固定文案和动态值，再考虑使用 t-string。
• 如果输出目标有安全约束，必须由专门处理器执行转义、参数绑定或白名单规则。
• 如果要兼容 Python 3.13 及更早版本，不能直接使用 t-string 语法，应先划定运行时版本。
• 不要把 Template 在多个模块之间无约束地传递；为它定义清晰的消费接口，避免每个调用方各自拼接。

一条实用的迁移路线是：先把原 f-string 的输出场景分类，再只把确实需要结构的场景替换为 t-string；随后为每种输出定义一个处理器，并覆盖无插值、多个插值、显式转换和格式说明符这几类输入。

迁移清单：从 f-string 切换到 t-string 前后各查什么

1. 确认运行时是 Python 3.14 或更高版本，构建和部署环境要保持一致。
2. 确认调用方需要的是 str 还是 Template，不要只按语法相似性替换前缀。
3. 读取 strings 与 interpolations 的对应关系，保留最后一个静态片段。
4. 对 conversion 和 format_spec 设计明确的处理策略。
5. 对 HTML、SQL、Shell 或日志等输出分别使用对应的安全边界，不能把 str() 当作通用安全方案。
6. 用无插值、单插值、多插值和异常值覆盖处理器的回归用例。

可以把这次升级记成一句话：f-string 负责得到文本，t-string 负责把文本和插值先保留下来。

相关问题

t-string 最终会不会得到普通字符串？

它本身得到的是 Template。是否转成普通字符串、怎样转成普通字符串，要由后续处理器决定。

Template.strings 和 Template.interpolations 如何对应？

静态字符串比插值多一个；第 i 个插值位于 strings[i] 与 strings[i + 1] 之间。

t-string 能自动防止 HTML 或 SQL 注入吗？

不能。t-string 只保留结构，安全输出仍需要使用目标格式对应的转义或参数化处理器。

Python 3.13 能直接解析 t-string 吗？

不能把 3.14 的 t-string 语法直接当作旧版本代码使用。需要兼容旧运行时的项目，应在语法入口和部署版本上先做迁移规划。