Python执行系统命令的所有方法实践教学

先说几个关键判断：在Python里跟操作系统打交道的方法有不少，但真正称得上“好钢用在刀刃上”的，其实就那么几个。从现代Python开发的最佳实践看，`subprocess`模块是绝对的主角，而早年那些`os.system()`之类的老古董，除非是在维护十年前的遗留代码，否则就让它安息在历史文档里吧。

执行系统命令，主要涉及os、subprocess和shutil这三个模块。如果目标是调用外部程序或执行Shell命令，现代Python（尤其是3.5及以上版本）的官方推荐只有一个——subprocess。它被设计出来，就是为了统一、并取代之前那些零散且不好用的执行方式。

为了让你一眼看明白各方法之间的优劣，先把核心对比列出来，方便随时查阅：

1. 最佳实践首选：subprocess.run()

这个是在Python 3.5版本中引入的高级函数，如今已是执行系统命令的“标准答案”，几乎可以应付你日常碰到的所有需求。它的精髓在于通过参数来精确控制命令的行为。

import subprocess

# 示例1：执行简单命令，不关心输出
result = subprocess.run(["ls", "-l"])  # 参数用列表传，能有效避免Shell注入风险
print(f"命令返回码: {result.returncode}") # 返回0通常意味着成功

# 示例2：执行命令并捕获标准输出
result = subprocess.run(["echo", "Hello from subprocess"], capture_output=True, text=True)
print(f"标准输出: {result.stdout}") # Hello from subprocess
print(f"标准错误: {result.stderr}") # 空字符串
print(f"返回码: {result.returncode}") # 0

# 示例3：执行Shell命令（用shell=True，但务必注意安全！）
result = subprocess.run("ls -l *.txt | wc -l", shell=True, capture_output=True, text=True)
print(f"当前目录下txt文件行数: {result.stdout.strip()}")

# 示例4：设置超时和错误处理
try:
    result = subprocess.run(["sleep", "5"], timeout=3, capture_output=True, text=True)
except subprocess.TimeoutExpired:
    print("命令执行超时，已被终止！")
except subprocess.CalledProcessError as e:
    # 当check=True且命令返回非零状态码时，会抛出这个异常
    print(f"命令执行失败: {e.stderr}")

2. 高级灵活控制：subprocess.Popen()

如果你觉得前面那个run()还是不够用，比如要跟进程做双向实时互动、逐行读取输出流、同时管理多个子进程，那就直接上Popen，它是这一切的底层基础。

import subprocess
import time

# 示例1：启动后台进程，回头再来等它结束
process = subprocess.Popen(["ping", "-c", "4", "example.com"], stdout=subprocess.PIPE, text=True)
# ... 这会儿可以去做别的事 ...
return_code = process.wait() # 等待进程跑完
output, _ = process.communicate() # 一次性读取所有输出
print(output)

# 示例2：实时读取进程输出（逐行模式）
process = subprocess.Popen(["tail", "-f", "/var/log/syslog"], stdout=subprocess.PIPE, text=True)
try:
    for line in iter(process.stdout.readline, ''):
        print(f"实时日志: {line.strip()}")
        time.sleep(0.1)
except KeyboardInterrupt:
    print("终止日志监控")
    process.terminate() # 发个SIGTERM信号
    process.wait()

# 示例3：管道连接多个命令（模拟 `ls -l | grep .py`）
ls_process = subprocess.Popen(["ls", "-l"], stdout=subprocess.PIPE)
grep_process = subprocess.Popen(["grep", ".py"], stdin=ls_process.stdout, stdout=subprocess.PIPE, text=True)
ls_process.stdout.close() # 让ls进程能收到SIGPIPE信号正常退出
output = grep_process.communicate()[0]
print(f"找到的.py文件:\n{output}")

3. 特定文件操作：shutil模块

这类任务有个特点：本质上虽然也调用了系统命令（比如cp、rm、tar），但我们并不需要直接和系统进程打交道。用shutil提供的Pythonic接口，既安全又跨平台，代码也更干净。

import shutil

# 示例1：跨平台复制文件/目录（内部可能调用了cp或copy）
shutil.copy2('source.txt', 'dest.txt')  # 保留文件元数据
shutil.copytree('source_dir', 'dest_dir') # 递归复制整个目录

# 示例2：移动文件/目录（内部可能调用了mv）
shutil.move('old_name.txt', 'new_name.txt')

# 示例3：删除整个目录树（内部可能调用了rm -rf）
shutil.rmtree('directory_to_delete')

# 示例4：归档压缩（内部调用tar、zip等命令）
shutil.make_archive('backup', 'zip', 'my_folder') # 创建zip压缩包
shutil.unpack_archive('backup.zip', 'extract_folder') # 解压

4. 简单遗留方法：os.system()

这是最古老的方式，直接把命令字符串扔给系统Shell去解释。它最大的问题在于——你根本拿不到命令的输出结果，只能知道它成功了还是失败了。

import os

return_code = os.system('echo Hello World')
# 屏幕上会打印出"Hello World"
# return_code的高8位是退出状态码，低8位是信号值。通常0就是成功。
if return_code == 0:
    print("命令执行成功")
else:
    print(f"命令失败，返回码: {return_code}")

5. 已淘汰的方法：os.popen()

它算是为了解决os.system()不能读取输出而做的补丁，能打开一个管道来读或写，但功能极其有限。早期Python手册里就已经明确建议新代码不要用，转投subprocess的怀抱。

import os

# 读取命令输出（过时写法）
output = os.popen('ls -l').read()
print(output)

# 写入命令输入（更少见）
os.popen('cat > output.txt', 'w').write('Some text')

最后再梳理一下几个要诀：

1. 首推 subprocess.run()： 覆盖95%以上的场景，安全、功能完备，是现代Python脚本的标准答案。
2. 深入用 subprocess.Popen()： 当你要处理异步、实时交互、复杂管道或底层进程控制时，它就是你的瑞士军刀。
3. 文件操作选 shutil： 处理文件、目录、归档操作时，它比直接调cp、rm、tar更优雅，也更安全。
4. 远离 os.system() 和 os.popen()： 在全新项目中，它们几乎没有存在的必要。功能弱、依赖Shell、有安全隐患、控制能力差——这个清单还可以继续列下去。
5. 安全永远放在第一位： 养成好习惯，尽量用列表形式传递命令和参数（比如 ['ls', '-l']），避免使用shell=True。如果因某些特殊原因不得不使用shell=True，一定确保所有参数都是可信的、不受外部污染的，否则Shell注入攻击会让你很难受。