Python2中Flask+Jinja2的Unicode编码显示异常问题求助

嘿，我来帮你搞定这个Unicode编码的坑！先给你理清楚问题根源，再一步步给你可行的解决方案。

问题根源：Python2的字符串类型混淆 #

Python2里有两种完全不同的字符串类型：

• str：本质是字节串（二进制数据），比如'Test-Asset comm\xc3\xa9'就是utf-8编码的字节串的字符串表示
• unicode：真正的Unicode文本，比如u'Test-Asset commé'

你的问题核心出在这几个环节：

1. 表单提交后，Flask在Python2下默认返回的表单值是str类型（utf-8字节串）
2. 你把字典转成字符串时（比如用了str(my_dict)），会把字节串直接转成带\x转义的字符串表示，而不是保留Unicode文本
3. 模板里用decode('utf-8')时，其实是在对已经被转义的字符串（比如'comm\xc3\xa9'这个字符串本身）做解码，自然得不到正确的字符

可行解决方案 #

1. 路由层先把表单数据转成Unicode #

处理表单提交时，先把str类型的表单值解码成unicode：

# 假设表单字段名为asset_name
asset_name = request.form['asset_name'].decode('utf-8')
# 把unicode存入字典，再放到列表里
my_list = [{'name': asset_name}]

2. 不要用str()序列化字典，用JSON模块 #

str(dict)会破坏Unicode格式，改用json.dumps来序列化，确保输出正确的Unicode文本：

import json

# 序列化字典为Unicode字符串（ensure_ascii=False会保留原始Unicode字符）
dict_str = json.dumps(my_dict, ensure_ascii=False)
# 存入列表
my_list = [dict_str]

3. 模板里直接渲染，无需手动decode #

如果你传给模板的是正确的unicode字符串，Jinja2会自动处理编码，直接渲染即可：

<!-- 不需要.decode('utf-8') -->
{{ item[0] }}

4. 给JS传递数据时用tojson过滤器 #

如果要把字符串传给JS做HTTP请求，用Jinja2的tojson过滤器，它会自动处理编码和转义，确保JS能正确解析：

<script>
  // 直接拿到可解析的字符串
  var assetName = {{ item[0]|tojson }};
  // 后续用这个变量发请求即可
</script>

纠正你之前的错误尝试 #

• encode('utf-8')：在Python2下，对unicode用这个会转成str字节串，传到模板后Jinja2会把字节串的转义形式显示出来，反而出错
• unicode(str)：如果str是已经带\x转义的字符串（比如'comm\xc3\xa9'），这个操作只会把它转成unicode类型的转义字符串，不会解码原始字节
• render_template().encode('utf-8')：Flask已经会自动处理响应的编码，手动encode会导致双重编码，反而出问题

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