使用subprocess执行pyenv多命令报错如何解决

云上老周

2026-9-1

问题根因

代码运行失败是多处写法不符合shell和subprocess调用规则导致的：

多命令分隔符使用错误：shell语法不支持用逗号分隔多条执行命令，传入的逗号会被识别为命令参数的一部分，最终pyenv把-l,pyenv整体当成了要安装的版本名，才会抛出「找不到对应版本定义」的错误。不同shell的多命令分隔规则为：Windows cmd下无条件顺序执行用&，前序命令执行成功才执行后续用&&；类Unix（Linux/macOS）的bash/zsh下无条件分隔用;，成功后执行同样用&&，不存在逗号分隔的用法。
参数不匹配：代码里定义的目标Python版本是3.9.6，执行安装的命令却写的是pyenv install 3.9.0，就算分隔符正确也会安装错误版本。
工作目录缺失：代码提前创建了D:/python_venv/3.9.6目录，但调用命令时没有指定执行路径，后续pyenv local、虚拟环境创建操作都会默认在脚本当前运行目录执行，和预期路径不符。
异常捕获逻辑失效：自定义的subprocess_cmd函数仅用Popen启动进程，没有做执行返回码校验，根本不会触发subprocess.CalledProcessError异常，外层的try/except完全无法捕获执行错误；同时函数只捕获了标准输出，没有捕获错误流，出问题时看不到具体报错信息。

修正代码

import os
import subprocess

def subprocess_cmd(command, cwd=None):
    # 同时捕获标准输出、错误流，指定编码避免乱码
    process = subprocess.Popen(
        command,
        stdout=subprocess.PIPE,
        stderr=subprocess.PIPE,
        shell=True,
        cwd=cwd,
        encoding='utf-8'
    )
    proc_stdout, proc_stderr = process.communicate()
    return_code = process.poll()
    # 非0返回码判定为执行失败，主动抛出异常供外层捕获
    if return_code != 0:
        raise subprocess.CalledProcessError(return_code, command, output=proc_stdout, stderr=proc_stderr)
    print(proc_stdout.strip())
    return proc_stdout.strip()

def run_cmd():
    python_version = "3.9.6"
    target_dir = f"D:/python_venv/{python_version}"
    os.makedirs(target_dir, exist_ok=True)

    try:
        # 按执行顺序组装命令，用&&拼接保证前一步成功才执行后续操作
        cmd_list = [
            f"pyenv install {python_version}",
            f"pyenv local {python_version}",
            "python -m venv .venv"
        ]
        # 如果需要先列出所有可安装版本，把"pyenv install -l"加到cmd_list最前即可
        full_cmd = " && ".join(cmd_list)
        subprocess_cmd(full_cmd, cwd=target_dir)
        print("虚拟环境创建完成")
    except subprocess.CalledProcessError as e:
        print(f"命令执行失败，返回码：{e.returncode}，错误信息：{e.stderr.strip()}")
        return None

if __name__ == "__main__":
    run_cmd()

注意事项

执行前要确认pyenv已经正确加入系统环境变量，否则会抛出找不到pyenv命令的错误
如果是在Linux/macOS环境运行，命令拼接符&&可以通用，只需要把目标路径改成对应系统的路径格式即可
Windows环境使用的是pyenv-win版本，执行pyenv install时会自动下载对应版本的预编译Python包，不需要额外安装编译依赖；Linux/macOS下需要提前安装Python编译所需的依赖包，否则安装版本会失败
可以额外增加版本存在判断逻辑，如果pyenv已经安装过目标Python版本，直接跳过install步骤，减少重复执行耗时

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