Python运行CMD命令获取返回值的核心方法与进阶技巧

推荐方案：基于 subprocess 的标准调用

在现代 Python（3.5+）环境中，subprocess 是执行外部程序、捕获输出与处理状态码的首选。通过合理配置参数，可以精准控制进程的生命周期与数据流向。

第一步：使用 subprocess.run 获取完整结果

目的：同步执行命令，同时获取标准输出、标准错误及退出状态码。
入口：subprocess.run()
动作：传入命令列表，开启捕获模式并指定文本解码。执行完毕后返回 CompletedProcess 对象，可直接访问 .stdout、.stderr 与 .returncode。

import subprocess

def run_command_full(cmd):
    # 推荐以列表形式传递参数，避免 shell 注入风险
    cmd_list = ['cmd.exe', '/c'] + cmd.split() 
    result = subprocess.run(
        cmd_list,
        capture_output=True,       # 捕获 stdout 和 stderr
        text=True,                 # 自动按 UTF-8 解码为字符串
        check=False                # 不抛出异常，交由返回值判断
    )
    if result.returncode == 0:
        return result.stdout.strip()
    else:
        raise RuntimeError(f"执行失败 (代码 {result.returncode}): {result.stderr.strip()}")

print(run_command_full("dir"))

第二步：使用 check_output 快速提取字符串

目的：适用于只需获取输出内容且期望命令成功的场景。若返回码非零，将直接触发 CalledProcessError。

import subprocess

def run_command_output(cmd):
    cmd_list = ['cmd.exe', '/c'] + cmd.split()
    # bytes 类型输出，需手动 decode
    raw_output = subprocess.check_output(cmd_list, shell=False)
    return raw_output.decode('utf-8').strip()

output = run_command_output("echo Hello")
print(output)

第三步：使用 Popen 处理交互式或长耗时任务

目的：需要实时读取进程输出、向子进程写入数据或在多任务环境中管理进程时使用。

import subprocess

def run_command_stream(cmd):
    cmd_list = ['cmd.exe', '/c'] + cmd.split()
    process = subprocess.Popen(
        cmd_list,
        stdout=subprocess.PIPE,
        stderr=subprocess.STDOUT,
        text=True,
        bufsize=1               # 行缓冲
    )
    # 迭代读取直至结束
    for line in process.stdout:
        print(line, end='')
    process.wait()
    print(f"\n最终返回码: {process.returncode}")

run_command_stream("ipconfig")

遗留方法与平台差异的对比说明

部分早期教程仍会推荐 os 模块或其他第三方库，但在实际工程中需注意其边界条件。

os.system 与 os.popen 的实际限制

os.system(command) 仅能返回执行后的退出状态码（0 表示成功），无法捕获任何屏幕输出，且输出会直接打印到当前控制台。此设计已不符合现代程序对数据流的管控需求，仅建议在调试阶段临时使用。os.popen() 虽能返回文件描述符读取内容，但自 Python 3.x 起已被标记为废弃，底层逻辑已由 subprocess.Popen 完全取代。

Windows 专属接口的适用场景

os.startfile() 主要用于唤醒关联应用程序打开指定文件，不适合用于执行后台脚本或解析返回数据。而 win32api.ShellExecute 与 CreateProcess 属于 Win32 API 封装，必须通过 pip install pywin32 引入依赖，且仅能在 Windows 平台运行。除非需要精细控制窗口显示样式（如隐藏控制台）或创建无父进程隔离的执行环境，否则不建议在跨平台项目中混用。

关键排错与安全规范

在执行系统命令时，以下两类问题最为常见：

• 编码乱码：部分老旧命令或特定区域设置下输出 GBK 编码。可在 subprocess.run 中显式指定 encoding='gbk' 或在读取后追加 .decode('gbk', errors='ignore')。
• Shell 注入漏洞：当命令来源于用户输入或环境变量时，严禁直接使用 shell=True 拼接字符串。应始终采用 [executable, arg1, arg2] 列表传参，由操作系统安全解析。
• 路径缺失报错：若执行非环境变量默认路径中的可执行文件，需补充 CWD 工作目录参数：cwd=r'C:\Path\To\Dir'。

总结

掌握 subprocess 的异步阻塞控制与流式读取特性，即可覆盖 90% 以上的自动化运维与 CLI 交互需求。规避已废弃模块，坚持列表化传参与显式编码声明，能大幅提升脚本的稳定性和安全性。以上就是Python运行CMD命令获取返回值详细内容，更多关于Python命令行交互与系统调用的资料请关注本站其它相关文章！