如何在Cheetah模板中正确渲染Unicode字符？

我之前也碰到过Cheetah处理Unicode动态变量的坑，结合你的情况（静态Unicode正常、动态变量被替换为替换字符，所有文件均为UTF-8编码），可以从这几个方向排查和解决：

• 确保动态变量本身是Unicode字符串（Python 2场景）
  如果你使用的是Python 2，Cheetah对字节串（str类型）和Unicode串的处理差异很大。如果你的variable是UTF-8编码的字节串，Cheetah在渲染时可能会用系统默认编码（比如ASCII）去解码，直接导致乱码或替换字符。

  解决办法：将动态变量显式转为Unicode类型：

  # 假设variable是从文件/数据库读取的字节串
  variable = variable.decode('utf-8')
  

• 加载模板时明确指定编码
  虽然你的模板文件是UTF-8编码，但Cheetah可能没有自动识别到，这会影响动态变量的编码协同处理。加载模板时务必指定编码参数：

  from Cheetah.Template import Template
  
  # 加载模板时指定utf-8编码
  template = Template(file='template.txt', fileEncoding='utf-8')
  template.variable = variable
  # Python 2中渲染为Unicode字符串
  output = unicode(template)
  # 写入文件时用utf-8编码输出
  with open('output.txt', 'w') as f:
      f.write(output.encode('utf-8'))
  

• 关闭Cheetah的自动过滤功能
  Cheetah默认会对变量做一些自动编码转换或过滤，这可能破坏Unicode字符。你可以在模板中给变量添加filter="none"来禁用自动处理：
  在template.txt中引用变量时：

  静态Unicode示例：你好
  动态Unicode内容：$variable(filter="none")
  

• 检查Python环境的默认编码（仅Python 2）
  Python 2的默认编码可能不是UTF-8，这会间接影响Cheetah的处理逻辑。可以在程序开头添加以下代码强制设置默认编码：

  import sys
  reload(sys)
  sys.setdefaultencoding('utf-8')
  

  注意：Python 3无需此操作，因为Python 3默认字符串为Unicode，且默认编码为UTF-8。

• 输出文件时明确指定UTF-8编码
  最后，写入输出文件时一定要确保用UTF-8编码，避免系统默认编码干扰。比如Python 3中的写法：

  with open('output.txt', 'w', encoding='utf-8') as f:
      f.write(str(template))
  

核心要点：确保动态变量是Unicode类型（Python 2）、模板加载和输出全链路明确指定UTF-8编码、禁用不必要的自动过滤，这几点应该能彻底解决你的动态Unicode字符被替换的问题。

内容的提问来源于stack exchange，提问作者Nijin22