Python subprocess系列接口运行指定exe脚本失败、CLI正常问题排查问询

• 工作目录不一致：VSCode调试运行脚本时的默认工作目录，与手动启动CLI运行Python解释器的工作目录存在差异。目标exe可能依赖同级目录下的配置文件、动态链接库等资源，工作目录错误会直接导致启动失败；而notepad属于系统级程序，不依赖运行时工作目录，因此可以正常启动。
• 权限差异：VSCode进程的运行权限与手动打开的CLI权限不匹配，比如目标exe需要管理员权限才能运行，而VSCode是普通用户身份启动，手动CLI是管理员身份启动，就会出现脚本运行失败、逐行运行正常的情况。
• 环境变量差异：VSCode调试时为Python进程分配的环境变量，与手动CLI的环境变量不一致。如果目标exe依赖特定的PATH、动态库加载路径等环境配置，VSCode环境中缺少对应配置就会启动失败。
• 输出重定向冲突：部分Windows GUI程序检测到标准输出、标准错误被重定向到管道时，会直接异常退出。脚本中使用subprocess.PIPE捕获输出触发了该机制，而逐行运行时可能未开启重定向，或运行环境的重定向检测逻辑未触发。
• 路径转义错误：部分代码中的文件路径未对反斜杠做完整转义，也未使用原始字符串标识，Python可能将\t这类字符解析为制表符，导致实际传入的路径错误。

• 强制指定运行工作目录：调用subprocess相关接口时新增cwd参数，指定为目标exe所在的目录，排除工作目录异常问题，示例如下：

import subprocess
cmd = ['C:\\temp\\temp_app\\target_application.exe', 'C:\\temp\\myfiles\\test_24.xml']
# 明确指定工作目录为exe所在文件夹
pipe = subprocess.Popen(cmd, cwd="C:\\temp\\temp_app\\", stdout=subprocess.PIPE, stderr=subprocess.PIPE)

• 移除shell=True参数：传递命令列表时无需开启shell解析，shell=True会额外增加一层cmd解析逻辑，反而容易引发路径、参数解析异常，直接删除该参数即可。
• 将输出重定向到本地文件：不要使用subprocess.PIPE捕获输出，将标准输出、错误直接写入本地文件，避免管道重定向冲突，同时可以留存完整日志：

with open("app_stdout.log", "w", encoding="utf-8") as f_out, open("app_stderr.log", "w", encoding="utf-8") as f_err:
    proc = subprocess.Popen(cmd, cwd="C:\\temp\\temp_app\\", stdout=f_out, stderr=f_err)
    proc.wait()

运行完成后查看两个日志文件的内容即可获取程序输出。

• 对比环境差异：分别在脚本开头、CLI逐行运行时执行以下代码，对比工作目录、环境变量的差异：

import os
# 打印当前工作目录
print(os.getcwd())
# 打印PATH环境变量
print(os.environ.get("PATH"))

• 查看系统事件日志：打开Windows事件查看器，依次进入「Windows日志→应用程序」，查找目标exe对应的崩溃错误记录，可获取到缺失dll、权限不足等底层错误原因。
• 修正路径写法：所有文件路径统一使用原始字符串标识，避免反斜杠转义异常，比如r"C:\temp\test\test_24.xml"。
• 修正subprocess.run的错误用法：subprocess.run本身会同步等待进程执行完成，无需额外调用wait()、communicate()，需要捕获输出时要显式指定capture_output=True参数：

proc = subprocess.run(cmd, cwd="C:\\temp\\temp_app\\", capture_output=True, encoding="utf-8")
print(proc.stdout)
print(proc.stderr)

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