使用Django truncatechars模板标签截断字符串时编码异常

我之前也碰到过类似的truncatechars导致编码乱码、截断结果不符合预期的情况，结合你的问题，咱们从几个常见方向来排查解决：

• 先确认字符串编码与环境一致性
  Django模板默认使用UTF-8编码，如果你的字符串是其他编码（比如Latin-1），或者数据库存储时编码不匹配，截断操作很容易破坏多字节字符结构，出现乱码。
  解决办法：在视图层把字符串统一转成UTF-8编码，比如：

  # 假设你的字符串是从数据库取出的old_str
  safe_str = old_str.encode('utf-8', errors='replace').decode('utf-8')
  

  同时检查数据库的字符集设置，确保是utf8mb4（支持所有Unicode字符，包括特殊语言字符）。

• 避免截断到多字节字符中间
  truncatechars是按字符数截断，但如果字符串里包含法语特殊字符（比如你的例子里的é）这类多字节Unicode字符，直接截断可能会切到字符的字节中间，导致编码损坏。
  这时候可以自定义一个安全截断的模板过滤器，确保不会破坏字符完整性：

  # 在你的app下创建templatetags/custom_filters.py
  from django import template
  
  register = template.Library()
  
  @register.filter(name='safe_truncate')
  def safe_truncate(value, max_len):
      if not isinstance(value, str) or len(value) <= max_len:
          return value
      # 先截断到目标长度，再回退到完整字符
      truncated = value[:max_len]
      # 循环检查最后一个字符是否完整，直到找到可截断的边界
      while True:
          try:
              truncated.encode('utf-8')  # 验证编码完整性
              break
          except UnicodeEncodeError:
              truncated = truncated[:-1]
              if not truncated:
                  break
      return f"{truncated}..."
  

  然后在模板里加载并使用：

  {% load custom_filters %}
  {{ your_string|safe_truncate:30 }}
  

• 检查模板转义影响
  如果你的字符串包含特殊字符，Django默认的自动转义可能会把字符转成HTML实体，截断后看起来像是编码损坏。可以尝试在截断后加上|safe过滤器（注意：仅当字符串是可信内容时使用，避免XSS风险）：

  {{ your_string|truncatechars:30|safe }}
  

• 核对截断长度参数
  最后再确认一下truncatechars的参数值是否符合你的预期，比如你想要得到une startup (jeune pousse, socié...，可以先数一下这个目标字符串的字符数，确保参数设置准确，避免因长度设置偏差导致截断结果不符。

内容的提问来源于stack exchange，提问作者Shihabudheen K M