Python字符串模板Template用法详解：substitute与safe_substitute差异分析

橘子海

发布时间：2026-10-13| 5人浏览过

原创

本文深入解析Python中string模块的Template类用法，重点对比substitute与safe_substitute两种格式化方法。通过代码实例展示在键值缺失时，前者抛出KeyError异常而后者保持原字符串不变的行为差异，帮助开发者根据安全性需求选择合适的数据填充策略。

本文通过具体实例详细解析Python中字符串模板（Template）的应用方法，供读者参考学习。

#coding=utf8
'''''
字符串格式化操作符，需要程序员明确转换类型参数，
比如到底是转成字符串、整数还是其他什么类型。
新式的字符串模板的优势是不用去记住所有相关细节，
而是像shell风格的脚本语言里面那样使用美元符号($).
由于新式的字符串引进Template对象，
Template对象有两个方法：substitute()、safe_substitute()。
substitute()更为严谨，在key缺少的情况下会报一个KeyError的异常。
safe_substitute()在缺少key的情况下，直接原封不动的把字符串显示出来。
'''
#导入Template对象
from string import Template
def stringTemplate():
  #创建一个Template实例tmp
  tmp=Template("I have ${yuan} yuan,I can buy ${how} hotdog")
  yuanList=[1,5,8,10,12,13]
  for yu in yuanList:
    #substitute()按照Template中string输出
    #并给相应key赋值
    Substitute= tmp.substitute(yuan=yu,how=yu)
    print Substitute
  print
  for yu in yuanList:
    #使用substitute函数缺少key值包KeyError
    try:
      lackHow= tmp.substitute(yuan=yu)
      print lackHow
      print
    except KeyError,e:
      print "substitute lack key ",e
  print
  for yu in yuanList:
    #safe_substitute()在缺少key的情况下
    #直接原封不动的把字符串显示出来。
    safe_substitute= tmp.safe_substitute(yuan=yu)
    print safe_substitute
  print
#调用stringTemplate函数
stringTemplate()

程序执行输出结果如下：