在 Python 中调用本地 exe 程序时,参数值或输出结果出现乱码,几乎是每位开发者都会遇到的典型问题。究其根本,原因在于编码不一致——Windows 系统默认采用 GBK/CP936 编码,而你的脚本可能使用的是 UTF-8,两者无法匹配,自然导致满屏乱码。

遇到这种情况,不必急于更换库。优先尝试调整 subprocess 的参数,90% 的乱码问题都能就地解决。如果仍有不足,再考虑引入第三方库,也为时不晚。
一、不换库:subprocess 本身即可应对乱码
subprocess 是 Python 官方推荐的底层调用库,功能十分强大。以下三种方法基本覆盖了所有乱码场景:
1. 明确指定编码格式(推荐)
调用 subprocess.run 或 Popen 时,直接添加 encoding 参数,让 Python 自动完成解码处理,既省心又高效。
import subprocess
# 明确指定使用 utf-8 编码进行交互
result = subprocess.run(
["your_exe.exe", "中文参数"],
capture_output=True,
encoding="utf-8" # 根据 exe 实际支持的编码填写,如 gbk 或 utf-8
)
print(result.stdout)
2. 手动处理字节流并解码
如果不指定 encoding,subprocess 返回的是 bytes 类型。拿到字节流后,手动用正确的编码进行解码,同时设置错误处理策略,避免个别非法字符导致程序崩溃。
result = subprocess.run(
["your_exe.exe", "中文参数"],
capture_output=True
)
# 手动解码,遇到无法解码的字符进行替换
stdout_str = result.stdout.decode("utf-8", errors="replace")
print(stdout_str)
3. 跨平台兼容性处理
Windows 与 Linux 默认编码不同,可以动态获取当前系统的编码,实现一套代码兼容多个平台。
import sys encoding = "utf-8" if sys.platform != "win32" else "gbk" subprocess.run(["your_exe.exe", "中文参数"], encoding=encoding)
二、更好用的第三方库推荐
如果觉得 subprocess 的底层 API 过于繁琐,希望获得更优雅的封装,以下两个库值得尝试。
1. sh(原 pbs)
sh 库将系统中的可执行程序直接映射为 Python 函数,调用起来如同编写脚本,参数传递智能,无需手动拆分命令字符串。
- 优点:语法极度简洁,自动处理参数列表。
- 示例:
import sh
# 直接像调用函数一样调用 exe,参数自动传递
output = sh.your_exe("中文参数", _encoding="utf-8")
print(output)
2. plumbum(PLUg-and-play composable shell)
专为系统编程设计的库,提供了类似 Shell 脚本的管道操作和命令行组合能力,对 Unicode 和跨平台支持极佳,异常处理也十分完善。
- 优点:支持管道(
|)、重定向(>),编码处理自动完成。 - 示例:
from plumbum import local exe = local["your_exe.exe"] # 使用管道或组合命令,自动处理编码 result = exe["中文参数"]() print(result)
总结建议
- 如果是偶发的乱码问题,优先为
subprocess添加encoding="utf-8"或encoding="gbk",这能解决九成以上的 Windows 乱码问题。 - 如果是频繁进行复杂的命令行调用,或需要构建管道、重定向等操作,推荐引入
plumbum或sh,代码可读性和开发效率都会明显提升。
