如何使用Python运行Google gsutil？Subprocess执行报错求助

首先咱们先理清楚问题：你在Windows CMD里能正常运行gsutil命令，但用Python subprocess调用时，设置shell=True就触发了ImportError。这大概率是因为shell=True时的环境变量和手动打开CMD的环境不一致——Cloud SDK依赖的Python环境没被正确加载，或者和系统自带的Python环境产生了冲突。

下面给你几个可行的解决方案：

方案1：用subprocess推荐的列表传参方式（避开shell=True） #

subprocess官方更推荐用列表形式传递命令和参数，这样不需要依赖shell解析，能直接避开环境变量的问题。代码示例：

import subprocess

# 把命令拆分成列表，每个元素对应一个参数
cmd = [
    "C:/Program Files (x86)/Google/Cloud SDK/google-cloud-sdk/bin/gsutil",
    "version"
]
# 捕获输出和错误，方便排查问题
p = subprocess.Popen(
    cmd,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True  # 让输出直接是字符串，无需手动解码
)
stdout, stderr = p.communicate()

print("输出结果：")
print(stdout)
if stderr:
    print("\n错误信息：")
    print(stderr)

方案2：如果必须用shell=True，先初始化Cloud SDK环境 #

手动打开CMD时，Cloud SDK的环境变量已经被自动加载（比如安装时配置的或者运行了gcloud init），但subprocess用shell=True启动的cmd.exe不会自动加载这些环境。你可以通过两种方式解决：

方法A：用gcloud命令替代直接调用gsutil #

gcloud会自动处理Cloud SDK的环境依赖，用它来执行gsutil相关操作更稳妥：

import subprocess

# 新版gcloud用storage替代了gsutil，旧版可以用"gcloud gsutil version"
cmd = "gcloud storage version"
p = subprocess.Popen(
    cmd,
    shell=True,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)
stdout, stderr = p.communicate()

print(stdout)
if stderr:
    print("错误：", stderr)

方法B：手动设置环境变量 #

如果一定要直接调用gsutil，可以先手动把Cloud SDK的路径加到环境变量里，指定它自带的Python：

import subprocess
import os

# 设置Cloud SDK的根路径
cloud_sdk_root = "C:/Program Files (x86)/Google/Cloud SDK/google-cloud-sdk"
# 把Cloud SDK的bin目录加入PATH
os.environ["PATH"] = f"{cloud_sdk_root}/bin;{os.environ['PATH']}"
# 指定用Cloud SDK自带的Python，避免和系统Python冲突
os.environ["CLOUDSDK_PYTHON"] = f"{cloud_sdk_root}/platform/bundledpython/python.exe"

cmd = "gsutil version"
p = subprocess.Popen(
    cmd,
    shell=True,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)
stdout, stderr = p.communicate()

print(stdout)
if stderr:
    print("错误：", stderr)

方案3：直接调用Cloud SDK自带的Python运行gsutil脚本 #

gsutil本质是一个Python脚本，你可以绕过shell，直接用Cloud SDK自带的Python执行它，彻底避开环境冲突：

import subprocess

# Cloud SDK自带的Python路径
cloud_python = "C:/Program Files (x86)/Google/Cloud SDK/google-cloud-sdk/platform/bundledpython/python.exe"
# gsutil脚本的路径
gsutil_script = "C:/Program Files (x86)/Google/Cloud SDK/google-cloud-sdk/bin/gsutil"

cmd = [cloud_python, gsutil_script, "version"]
p = subprocess.Popen(
    cmd,
    stdout=subprocess.PIPE,
    stderr=subprocess.PIPE,
    text=True
)
stdout, stderr = p.communicate()

print(stdout)
if stderr:
    print("错误：", stderr)

你可以先试试方案1，这是最稳妥的方式，一般能解决大部分问题。如果还是有问题，看看ImportError提示的具体模块是什么，再针对性调整环境变量或者Python路径。

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