Python调用Git输出与Shell执行不一致问题排查

问题场景 #

执行以下Python脚本提取Git提交信息时，输出的提交标题会带单引号，但在Bash中直接执行视觉上相同的命令，输出的标题没有引号：

import os
import subprocess

result = None
command = [ "git", "log", "--since=\"2022-10-13T17:40:05.232777\"", "--name-only", "--pretty=format:'%f'" ]
print("RUN: "+" ".join(command))
try:
    result = subprocess.run(command, check=True, capture_output=True)
except subprocess.CalledProcessError as e:
    result = e
print("Stdout:")
print(result.stdout.decode("utf8"))
print("Stderr:")
print(result.stderr.decode("utf8"))

核心原因 #

这是subprocess列表传参和Bash命令解析逻辑的本质差异导致的：

• 在Bash中，引号（单引号、双引号）是shell的语法标记，作用是明确参数边界（比如包含空格的参数），shell解析命令时会去掉这些引号，只把引号包裹的内容作为参数传递给Git程序。例如--pretty=format:'%f'被Bash解析后，实际传给Git的参数是--pretty=format:%f。
• 但Python的subprocess使用列表传参时，每个列表元素会直接作为原始参数传递给目标程序，不会经过shell的解析步骤。所以你写的--pretty=format:'%f'会原封不动传给Git，Git会把单引号当成格式字符串的一部分，最终输出时就会带上单引号。
• 同理，--since=\"2022-10-13T17:40:05.232777\"里的转义双引号也会被当成参数的一部分，可能导致Git无法正确解析时间条件。

解决方法 #

方法1：去掉参数中的引号（推荐） #

直接修改command列表，移除所有不必要的引号，让参数直接对应Git需要的格式：

import os
import subprocess

result = None
# 移除参数里的单引号、转义双引号
command = [ 
    "git", 
    "log", 
    "--since=2022-10-13T17:40:05.232777", 
    "--name-only", 
    "--pretty=format:%f" 
]
print("RUN: "+" ".join(command))
try:
    result = subprocess.run(command, check=True, capture_output=True)
except subprocess.CalledProcessError as e:
    result = e
print("Stdout:")
print(result.stdout.decode("utf8"))
print("Stderr:")
print(result.stderr.decode("utf8"))

方法2：启用shell解析（不推荐，有安全风险） #

如果一定要模拟Bash的解析逻辑，可以设置shell=True，此时命令需要写成字符串形式（而非列表）：

import os
import subprocess

result = None
command = "git log --since=\"2022-10-13T17:40:05.232777\" --name-only --pretty=format:'%f'"
print("RUN:", command)
try:
    # 启用shell=True，让shell解析命令
    result = subprocess.run(command, check=True, capture_output=True, shell=True)
except subprocess.CalledProcessError as e:
    result = e
print("Stdout:")
print(result.stdout.decode("utf8"))
print("Stderr:")
print(result.stderr.decode("utf8"))

注意：这种方式存在命令注入风险，若命令包含用户输入，绝对不要使用。

内容的提问来源于stack exchange，提问作者Tomáš Zato