问题现象描述

在Python开发中，处理中文字符时常见以下问题：

• 控制台输出显示为乱码（如：��� 或 æ��å��）
• 运行时报错：UnicodeEncodeError: 'ascii' codec can't encode characters
• 文件读写时中文内容异常
• 不同操作系统环境表现不一致

UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-3: ordinal not in range(128)

问题根源分析

Python中文问题主要由以下原因造成：

解决方案大全

#!/usr/bin/env python
# -*- coding: utf-8 -*-

print("中文内容可以正常显示了！")

import sys
import codecs

# 设置标准输出编码为UTF-8
sys.stdout = codecs.getwriter("utf-8")(sys.stdout.detach())

print("中文字符测试")

import sys

if sys.platform == "win32":
    # Windows控制台使用GBK编码
    sys.stdout = open(sys.stdout.fileno(), mode='w', encoding='gbk', buffering=1)
else:
    # 其他平台使用UTF-8
    sys.stdout = open(sys.stdout.fileno(), mode='w', encoding='utf-8', buffering=1)

print("中文在Windows命令提示符下正常显示")

# -*- coding: utf-8 -*-
from __future__ import unicode_literals
import sys

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

text = "中文内容"
print(text.encode('utf-8'))

最佳实践建议

完整解决方案示例

这是一个适用于大多数环境的完整解决方案：

#!/usr/bin/env python
# -*- coding: utf-8 -*-

"""
Python中文打印通用解决方案
适用于Python 2.7+ 和 Python 3.x
"""

import sys
import platform

def setup_encoding():
    """配置系统编码环境"""
    # 获取当前系统平台
    current_platform = platform.system()
    
    try:
        # Python 3的处理方式
        if sys.version_info.major == 3:
            # Windows系统使用GBK编码
            if current_platform == "Windows":
                sys.stdout = open(sys.stdout.fileno(), mode='w', 
                                encoding='gbk', errors='replace', buffering=1)
            # 其他系统使用UTF-8
            else:
                sys.stdout = open(sys.stdout.fileno(), mode='w', 
                                encoding='utf-8', errors='replace', buffering=1)
        # Python 2的处理方式
        else:
            reload(sys)
            sys.setdefaultencoding('utf-8')
            # Windows特殊处理
            if current_platform == "Windows":
                import codecs
                sys.stdout = codecs.getwriter('gbk')(sys.stdout)
    except Exception as e:
        print(f"编码设置错误: {str(e)}")

if __name__ == "__main__":
    setup_encoding()
    print("=" * 50)
    print("Python中文打印测试成功！")
    print(f"Python版本: {sys.version}")
    print(f"操作系统: {platform.platform()}")
    print(f"当前编码: {sys.stdout.encoding}")
    print("测试中文：你好，世界！")
    print("=" * 50)

总结

解决Python中文打印问题的关键在于理解编码原理并正确配置环境：

1. 始终在Python文件开头添加编码声明
2. 根据操作系统和Python版本动态设置输出编码
3. 优先使用Python 3开发新项目
4. 统一使用UTF-8编码标准
5. 在Windows环境下特别注意终端编码设置