本文详细讲解了在 Python 中执行 Windows CMD 命令的四种主要方法。首先介绍了标准库 subprocess 模块的最佳实践，包括参数配置、错误处理和超时控制；其次分析了 os 模块的简单用法及其局限性；接着探讨了 pyautogui 在 GUI 自动化中的应用及依赖条件；最后说明了 ctypes 库在 Windows 底层调用中的使用场景。文章重点强调了 shell=True 带来的命令注入安全风险，并提供了安全的编码建议和对比表格，帮助开发者根据实际需求选择最合适的技术方案。
在 Python 开发中，执行系统命令（如 Windows 的 CMD 或 Linux 的 Shell）是一项常见且实用的任务。它可以帮助开发者自动化文件处理、系统管理、数据清洗以及与其他工具交互等场景。Windows 环境下，CMD 命令行提供了丰富的系统控制能力。
本文将详细介绍如何在 Python 中安全、高效地执行 CMD 命令的多种方法，包括使用标准库 subprocess、os 模块，以及第三方库 pyautogui 和底层 ctypes 库。我们将对比它们的优缺点，并提供最佳实践建议。
subprocess 模块是 Python 3.x 的标准库之一，用于创建和管理子进程。它是执行系统命令的首选方案，因为它提供了强大的灵活性、安全性以及对输入输出流的精细控制。
以下示例演示如何使用 subprocess.run() 执行简单的 CMD 命令：
import subprocess
# 执行 dir 命令，shell=True 表示在 shell 环境中执行
result = subprocess.run('dir', shell=True, stdout=subprocess.PIPE, text=True)
# 打印命令输出
print(result.stdout)
参数说明：
shell=True：允许使用 shell 特性（如管道 |、重定向 >），但在 Windows 上默认值为 True，Linux 上为 False。注意：使用 shell=True 时需谨慎处理用户输入，以防命令注入攻击。stdout=subprocess.PIPE：捕获命令的标准输出。text=True (Python 3.7+)：返回字符串而非字节流，方便直接处理文本。在实际应用中，捕获异常和处理非零退出码至关重要：
import subprocess
try:
result = subprocess.run(
'ping -n 4 127.0.0.1',
shell=True,
stdout=subprocess.PIPE,
stderr=subprocess.PIPE,
text=True,
timeout=10
)
if result.returncode == 0:
print("命令执行成功")
print(result.stdout)
else:
print(f"命令执行失败，错误代码：{result.returncode}")
print(result.stderr)
except subprocess.TimeoutExpired:
print("命令执行超时")
except Exception as e:
print(f"发生未知错误：{e}")
对于需要持续交互的命令（如启动一个长期运行的服务），可以使用 Popen 类：
import subprocess
# 启动一个后台进程
proc = subprocess.Popen(['cmd', '/c', 'echo Hello'], stdout=subprocess.PIPE)
output, _ = proc.communicate()
print(output.decode())
os 模块提供了访问操作系统功能的接口。虽然它主要用于文件和目录操作，但其 system() 函数也可以执行命令。
import os
# 执行 dir 命令
os.system('dir')
os.system() 直接将输出打印到控制台，无法在 Python 程序中获取结果进行后续处理。os.system 存在，但不同系统的命令语法差异大，不如 subprocess 灵活。因此，除非仅需简单执行且不关心输出，否则不推荐使用此方法。
pyautogui 是一个第三方库，主要用于模拟鼠标和键盘操作。它适用于无法通过 API 调用的老旧软件或特定 GUI 场景。
当目标程序没有提供命令行接口，或者需要通过图形界面触发某些操作时，可以使用此方法模拟用户行为。
import pyautogui
import time
# 打开运行框
pyautogui.hotkey('win', 'r')
time.sleep(0.5)
# 输入 CMD 并回车
pyautogui.write('cmd')
pyautogui.press('enter')
time.sleep(1)
# 输入命令
pyautogui.write('dir')
pyautogui.press('enter')
ctypes 库允许 Python 与 C 语言库进行交互。在 Windows 上，可以通过调用 WinAPI 来执行命令。
import ctypes
# 调用 kernel32.dll 中的 WinExec 函数
# 第一个参数：命令字符串
# 第二个参数：SW_SHOWNORMAL (1) 显示窗口
ctypes.windll.kernel32.WinExec('cmd /c dir', 1)
在执行外部命令时，安全性是首要考虑因素。
永远不要将不可信的用户输入直接拼接到命令字符串中。如果必须使用 shell=True，请尽量使用列表形式传递参数，避免解析 shell 特殊字符。
# 危险做法
user_input = input("Enter file name: ")
subprocess.run(f'cat {user_input}', shell=True) # 若 user_input 包含 ; rm -rf，则危险
# 安全做法
subprocess.run(['cat', user_input]) # 即使包含特殊字符，也被视为文件名的一部分
防止命令死锁或无限挂起，始终为长时间运行的命令设置 timeout 参数。
确保运行 Python 脚本的账户具有执行所需命令的最小必要权限，遵循最小权限原则。
| 方法 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| subprocess | 灵活、可捕获输出、支持错误处理、跨平台 | 配置稍复杂 | 绝大多数自动化任务 |
| os.system | 语法简单 | 无法捕获输出、安全性低 | 快速测试、忽略输出 |
| pyautogui | 可操作 GUI、无需 API | 依赖桌面环境、不稳定 | 老旧软件、无 CLI 接口应用 |
| ctypes | 底层调用、速度快 | 仅限 Windows、难调试 | 特定 Windows 系统调用 |
在 Python 中执行 CMD 命令是实现系统自动化的关键技能。subprocess 模块凭借其强大的功能和安全性，应作为首选方案。os 模块适合简单场景，而 pyautogui 和 ctypes 则针对特定的 GUI 或底层需求。开发者应根据具体业务场景选择合适的方法，并始终重视命令执行的安全性，避免潜在的系统风险。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online