如何在Python 3中设置sys.stdout编码？

Question

在 Python 2 中设置默认输出编码是一个众所周知的习惯用法：

sys.stdout = codecs.getwriter("utf-8")(sys.stdout)

这将 sys.stdout 对象包装在编解码器编写器中，以 UTF-8 编码输出。

然而，这种技术在Python 3中不起作用，因为sys.stdout.write()需要一个str，但编码的结果是bytes ，并且当 codecs 尝试将编码字节写入原始 sys.stdout 时会发生错误。

在 Python 3 中执行此操作的正确方法是什么？

Answer 1

从Python 3.7开始，您可以使用 更改标准流的编码reconfigure()：

sys.stdout.reconfigure(encoding='utf-8')

您还可以通过添加 errors 参数来修改编码错误的处理方式。

Answer 2

Python 3.1 添加了 io.TextIOBase.detach()，并在文档中添加了 sys.stdout：

标准流默认为文本模式。要向其中写入或读取二进制数据，请使用底层二进制缓冲区。例如，要将字节写入 stdout，请使用 sys.stdout.buffer.write(b'abc')。默认情况下，使用 io.TextIOBase.detach() 流可以变成二进制。此函数将 stdin 和 stdout 设置为二进制：

def make_streams_binary():
    sys.stdin = sys.stdin.detach()
    sys.stdout = sys.stdout.detach()

因此，Python 3.1 及更高版本的相应习惯用法是：

sys.stdout = codecs.getwriter("utf-8")(sys.stdout.detach())

Answer 3

我在搜索相同错误的解决方案时发现了这个线程，

已经建议的替代解决方案是在Python启动之前设置PYTHONIOENCODING环境变量，供我使用 - 这比 Python 初始化后交换 sys.stdout 麻烦更少：

PYTHONIOENCODING=utf-8:surrogateescape python3 somescript.py

优点是不必去编辑 Python 代码。

Answer 4

其他答案似乎建议使用 codecs，但 open 对我有用：

import sys
sys.stdout = open(sys.stdout.fileno(), mode='w', encoding='utf8', buffering=1)
print("日本語")
# Also works with other methods of writing to stdout:
sys.stdout.write("日本語\n")
sys.stdout.buffer.write("日本語\n".encode())

即使我使用 PYTHONIOENCODING="ascii" 运行它，它也有效。

Answer 5

在 Python 2 中设置默认输出编码是一个众所周知的习惯用法

Eek!这是 Python 2 中众所周知的习惯用法吗？对我来说，这似乎是一个危险的错误。

它肯定会弄乱任何尝试将二进制写入标准输出的脚本（例如，如果您是返回图像的 CGI 脚本，则需要它）。字节和字符是完全不同的动物；将指定接受字节的接口与仅接受字符的接口进行猴子修补并不是一个好主意。

CGI 和 HTTP 通常明确地使用字节。您应该只向 sys.stdout 发送字节。在 Python 3 中，这意味着使用 sys.stdout.buffer.write 直接发送字节。对页面内容进行编码以匹配其 charset 参数应该在应用程序中的更高级别进行处理（如果您返回文本内容，而不是二进制内容）。这也意味着 print 不再适合 CGI。

（更令人困惑的是，wsgiref 的 CGIHandler 直到最近才在 py3k 中被破坏，使得无法以这种方式将 WSGI 部署到 CGI。使用 PEP 3333 和 Python 3.2，这终于可行了。）

Answer 6

使用 detach() 会导致解释器在退出之前尝试关闭 stdout 时打印警告：

Exception ignored in: <_io.TextIOWrapper mode='w' encoding='UTF-8'>
ValueError: underlying buffer has been detached

相反，这对我来说效果很好：（

default_out = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')

当然，写入 default_out< /code> 而不是标准输出。）

Answer 7

sys.stdout 在 Python 3 中处于文本模式。因此，您可以直接向其写入 unicode，而不再需要 Python 2 的习惯用法。

在 Python 2 中这会失败：

>>> import sys
>>> sys.stdout.write(u"ûnicöde")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
UnicodeEncodeError: 'ascii' codec can't encode character u'\xfb' in position 0: ordinal not in range(128)

然而，它在 Python 3 中工作得很好：

>>> import sys
>>> sys.stdout.write("Ûnicöde")
Ûnicöde7

现在，如果你的 Python 不知道你的 stdouts 编码实际上是什么，那就是一个不同的问题，很可能是在 Python 的构建中。