Python subprocess中text=True的默认编码是什么？如何配置？

一、默认编码的来源 #

当使用 text=True（或旧版别名 universal_newlines=True）且未指定 encoding 参数时，subprocess 会采用当前系统的默认编码，具体由 Python 的 locale.getpreferredencoding(False) 函数返回值决定。

这个编码并非固定值，会随操作系统和系统区域设置变化：

• Windows 环境下，简体中文系统通常是 GBK；Windows 10/11 若开启 UTF-8 系统区域设置，则默认编码为 UTF-8；
• Linux/macOS 等类 Unix 系统上，一般依赖系统的 LANG/LC_* 环境变量，主流配置下默认是 UTF-8。

二、编码的设置逻辑 #

subprocess 内部在启用文本模式时，会调用 locale.getpreferredencoding(False) 获取编码，用于解码子进程的 stdout/stderr 输出，同时也会用该编码编码 stdin 输入。

这里的 False 参数表示不启用 locale 的 fallback 机制，直接返回当前系统配置的首选编码。

三、编码的配置方式 #

完全可以配置，常见方式有三种：

1. 临时修改 Python 进程的 locale #

通过调用 locale.setlocale 临时改变当前 Python 进程的首选编码：

import locale
# 将编码临时改为 UTF-8（需系统已安装对应locale包）
locale.setlocale(locale.LC_ALL, 'en_US.UTF-8')
# 后续subprocess使用text=True时会采用该编码

注意：这种方式依赖系统已安装目标 locale，Windows 环境可能需要额外配置。

2. 显式指定 encoding 参数（推荐） #

最稳妥的方式是在调用 subprocess 函数时直接指定 encoding，完全绕过系统默认编码，避免跨环境差异：

import subprocess
# 强制用UTF-8解码子进程输出
result = subprocess.run(['echo', '测试'], text=True, encoding='utf-8', capture_output=True)
print(result.stdout)

3. 修改系统级区域设置（全局生效） #

• Windows：通过「控制面板 → 区域 → 管理 → 更改系统区域设置」开启 UTF-8 支持；
• Linux/macOS：修改 ~/.bashrc 或 /etc/profile 中的 LANG 变量，例如设置 export LANG=en_US.UTF-8，重启终端后生效。

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