python 的 string.template 模块提供安全、简洁的字符串替换，不解析表达式，避免代码注入；支持 $name/${name} 占位符、$$ 转义、safe_substitute 容错及自定义分隔符。
Python 的 string.Template 模块提供了一种简单、安全的字符串替换方式，特别适合面向用户输入或需要避免代码注入的场景。
为什么用 Template 而不是 % 或 f-string？
string.Template 的语法更简洁、容错性更强，不解析表达式，不会执行任意代码，因此比 % 格式化或 f-string 更安全。例如用户提交的模板字符串中若含 ${user_input}，Template 只做字面替换；而用 eval 或 f-string 动态拼接则可能引发安全问题。
它默认使用 $name 或 ${name} 占位符，也支持自定义分隔符，适合生成配置文件、邮件模板、HTML 片段等。
基础用法：substitute() 和 safe_substitute()
最常用的是 substitute() 和 safe_substitute() 两个方法：
立即学习“Python免费学习笔记（深入）”；
-
substitute(mapping, **kws)：严格匹配，缺一个占位符就抛KeyError -
safe_substitute(mapping, **kws)：缺失键时保留原占位符（如$missing不变），适合不确定是否提供全部变量的场景
示例：
from string import Template t = Template('Hello $name, you have $count messages.') print(t.substitute(name='Alice', count=5)) # Hello Alice, you have 5 messages. print(t.safe_substitute(name='Bob')) # Hello Bob, you have $count messages.
支持嵌套与转义写法
占位符可写成 ${name} 形式，便于在相邻字符中明确边界，比如 ${name}123 不会误识别为 $name123。双美元符号 $$ 表示字面量 $：
t = Template('Price: $$${price} (tax included)') print(t.substitute(price=99.9)) # Price: $99.9 (tax included)
自定义分隔符（进阶用法）
继承 Template 类并重写 delimiter 和/或 idpattern，可适配其他模板风格，例如用 [[name]] 替代 $name：
from string import Template <p>class DoubleBracketTemplate(Template): delimiter = '[[' pattern = r''' [[ (?: (?P<escaped>[[) | (?P<named>[_a-z][_a-z0-9]<em>) ]] | (?P<braced>[_a-z][_a-z0-9]</em>) ]] | (?P<invalid>) ) '''</p><p>t = DoubleBracketTemplate('Welcome [[name]]! You have [[count]] items.') print(t.substitute(name='Tom', count=3)) # Welcome Tom! You have 3 items.</p>