Python 3中如何将字符串作为双参数传递给调用Diffutils的subprocess

我懂你遇到的问题了——之前用相对路径拼接的方式调用diff.exe没问题，但换成两个独立的字符串路径参数就卡壳了对吧？这其实是subprocess传参时很容易踩的小坑，咱们一步步来解决。

问题根源：参数传递的正确姿势 #

很多人会犯的错误是把整个命令（包括两个路径）拼成一个字符串传给subprocess.run()的args参数，比如：

# 错误示例：把所有内容拼成一个字符串
subprocess.run("diff.exe 1.txt 2.txt", capture_output=True, text=True)

在Windows环境下，subprocess默认shell=False，这时候它会把整个字符串当成一个完整的命令名去查找，而不是拆分成diff.exe、1.txt、2.txt三个独立参数，自然会报错找不到文件。

正确的解决方案：用列表传递参数 #

subprocess推荐的传参方式是把每个独立的参数（命令本身、文件路径等）都作为列表的一个元素，这样它能正确识别每个参数的边界，不管你的路径是字符串形式的绝对路径还是相对路径都能正常工作。

给你个完整的示例代码：

import subprocess

# 定义两个字符串形式的文件路径（可以是绝对路径或相对路径）
file_path_1 = "C:\\my_files\\first.txt"
file_path_2 = "./second.txt"  # 相对路径也没问题

# 核心：args是列表，每个参数单独成项
diff_result = subprocess.run(
    ["diff.exe", file_path_1, file_path_2],
    capture_output=True,
    text=True,
    check=False  # 如果不想让diff的非0退出码触发异常，设为False
)

# 输出结果
print("文件差异：")
print(diff_result.stdout)
if diff_result.stderr:
    print("错误信息：")
    print(diff_result.stderr)

额外注意点 #

• diff.exe的路径：如果diff.exe不在系统的PATH环境变量里，你需要传入它的完整路径作为列表的第一个元素，比如：

  ["C:\\Program Files\\GnuWin32\\bin\\diff.exe", file_path_1, file_path_2]
  

• 关于shell=True：虽然设置shell=True可以让你用字符串形式传参（比如subprocess.run(f"diff.exe {file_path_1} {file_path_2}", shell=True)），但这种方式有安全风险（比如路径含特殊字符会被解析执行），而且跨平台兼容性差，非常不推荐在生产代码里用。

为什么之前拼接路径能工作？ #

你之前用相对路径拼接的方式能运行，应该是因为当时只处理单个路径参数，或者是用了某种方式把路径正确拆成了列表元素，而现在两个独立的路径参数必须明确分开成列表项才行。

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