Python 操作 CMD 命令行详解与实战

二、Python 中的 subprocess 模块

subprocess 模块是 Python 中用于创建新进程、连接到子进程并与其进行通信的标准库。相比 os.system，它更灵活、安全，支持流式读写、超时控制和错误处理。

1. 获取 CMD 命令的输出

使用 subprocess.run() 是最推荐的方式。参数 capture_output=True 表示捕获标准输出和标准错误，text=True 确保返回字符串而非字节。

import subprocess

# 执行 CMD 命令并获取输出
result = subprocess.run(
    ["dir"], 
    capture_output=True, 
    text=True,
    encoding='gbk' # Windows CMD 常用编码
)

# 打印输出结果
if result.returncode == 0:
    print(result.stdout)
else:
    print(f"错误信息：{result.stderr}")

2. 向 CMD 写入输入

部分命令需要交互式输入，可通过 input 参数传递数据。

import subprocess

# 执行 echo 命令并写入输入
result = subprocess.run(
    ["echo", "Hello World"], 
    input="www.example.com", 
    capture_output=True, 
    text=True
)
print(result.stdout.strip())

3. 高级用法：Popen 与管道

对于需要实时交互或后台运行的进程，可使用 subprocess.Popen。

import subprocess

# 启动后台进程
proc = subprocess.Popen(["ping", "8.8.8.8"], stdout=subprocess.PIPE, stderr=subprocess.PIPE)

# 读取输出
stdout, stderr = proc.communicate()
print(stdout.decode())

三、Python 中的 shutil 模块

shutil 模块提供了高层文件操作接口，常用于复制、移动、删除文件和文件夹，比直接调用底层 API 更安全便捷。

1. 复制文件和文件夹

shutil.copy(src, dst) 复制文件内容，shutil.copytree(src, dst) 递归复制整个目录树。

import shutil
import os

# 确保目标目录存在
os.makedirs("test", exist_ok=True)

# 复制文件
try:
    shutil.copy("example.txt", "test/")
    print("文件复制成功")
except FileNotFoundError:
    print("源文件不存在")

2. 移动文件和文件夹

shutil.move(src, dst) 将文件或文件夹移动到指定位置，若目标在同一磁盘则重命名，跨盘则复制后删除原文件。

import shutil

# 移动文件
shutil.move("example.txt", "test/example_moved.txt")

3. 删除文件和文件夹

shutil.rmtree(path) 可删除非空文件夹及其所有内容，os.remove(path) 仅删除文件。

import os
import shutil

# 删除文件
if os.path.isfile("example.txt"):
    os.remove("example.txt")

# 删除文件夹及其所有内容
if os.path.isdir("test"):
    shutil.rmtree("test")

四、安全性与最佳实践

1. 防止命令注入

在使用 subprocess 时，务必避免拼接字符串传递给 shell=True。始终使用列表形式传递参数。

# ❌ 危险示例
user_input = "test; rm -rf /"
subprocess.run(f"echo {user_input}", shell=True)  # 可能导致严重破坏

# ✅ 安全示例
subprocess.run(["echo", user_input])  # 参数被转义，不会执行恶意命令

2. 跨平台兼容性

Windows 使用 CMD/PowerShell，Linux/macOS 使用 Bash/Zsh。命令语法不同（如 dir vs ls），代码应做适配。

import platform
import subprocess

system = platform.system()
command = ["ls"] if system != "Windows" else ["dir"]

result = subprocess.run(command, capture_output=True, text=True)
print(result.stdout)

3. 异常处理与超时

长时间运行的命令可能导致程序挂起，应设置 timeout 参数。

import subprocess

try:
    result = subprocess.run(
        ["sleep", "10"], 
        timeout=5, 
        capture_output=True, 
        text=True
    )
except subprocess.TimeoutExpired:
    print("命令执行超时")

五、总结

通过 Python 操作 CMD，我们可以方便地执行命令、获取输出、创建、复制、移动和删除文件和文件夹等操作。使用 os、subprocess 和 shutil 等模块，我们可以轻松玩转命令行控制，提高工作效率。

在实际开发中，建议遵循以下原则：

1. 优先使用 subprocess 代替 os.system。
2. 始终验证用户输入，防止命令注入。
3. 处理编码问题，特别是在 Windows 环境下。
4. 为长耗时命令添加超时机制。

希望本文能对您有所帮助，助您更好地使用 Python 进行系统管理与自动化控制。