调试Python代码时中文变量显示为Unicode的问题咨询

我之前调试Python的时候也碰到过中文变量显示成\uXXXX这种Unicode编码的情况，折腾了好一会儿才弄明白，给你梳理下原因和对应的解决办法：

• Python版本的编码差异：
  如果你用的是Python2，它的默认编码是ASCII，中文无法直接被正确解析，就会被转成Unicode编码显示；就算是Python3（默认UTF-8），如果某些调试环节的编码没跟上，也可能出现这个问题。
• 调试工具/环境的编码配置问题：
  很多IDE或者调试器（比如旧版PyCharm、VS Code的终端、pdb）如果默认输出编码不是UTF-8，就会把中文转义成Unicode编码来输出，避免乱码，但反而导致可读性变差。
• 代码里的显式编码处理：
  比如你不小心用了repr()函数输出变量（repr()会返回对象的“官方”字符串表示，中文会转成Unicode），或者用json.dumps()时没关ensure_ascii=True（默认开启，会把中文转成Unicode编码）。

针对上面的原因，对应调整就行：

• 适配Python版本的编码设置：
  • Python2：在代码文件最开头加上# -*- coding: utf-8 -*-，同时处理中文时尽量用unicode()类型，比如name = u"张三"，输出时用print(u"姓名：%s" % name)。
  • Python3：虽然默认是UTF-8，但也可以在文件开头加# -*- coding: utf-8 -*-做个保险，确保文件编码正确。
• 调整调试工具的编码配置：
  • PyCharm：打开File > Settings > Editor > File Encodings，把「Global Encoding」「Project Encoding」「Default encoding for properties files」都设为UTF-8；再去Run/Debug Configurations里，检查Console的编码是否为UTF-8。
  • VS Code：打开设置（快捷键Ctrl+,），搜索并设置"terminal.integrated.encoding": "utf-8"和"python.terminal.encoding": "utf-8"，保存后重启调试。
  • pdb调试：启动pdb时可以指定编码，比如用命令python -c "import sys; sys.stdout.encoding='utf-8'; import pdb; pdb.set_trace()"，或者进入pdb后执行!sys.stdout.encoding='utf-8'来临时调整。
• 修正代码里的输出逻辑：
  • 不要用repr()输出中文变量，改用str()或者直接print，比如print(我的中文变量)而不是print(repr(我的中文变量))。
  • 如果是json序列化导致的，调用json.dumps()时加上ensure_ascii=False参数，比如json.dumps(数据, ensure_ascii=False)，这样中文就能正常显示。
  • 确保变量是正确的字符串类型：Python3里用str，Python2里用unicode，避免字节串（bytes）直接输出导致的编码问题。

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