使用Python调用本地exe程序的实现方案

用 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，代码的可读性和开发效率都会明显提升。