pyenv原生的局限 #

pyenv本身没法直接处理你这种格式的.python-version文件，自动完成「安装指定Python版本+创建并激活虚拟环境」的全流程。原生的.python-version如果写虚拟环境名称，前提是这个环境已经存在、对应的Python版本也已经装好，pyenv只会帮你切换过去，不会自动补全安装或创建步骤。

最靠谱的方式：自定义脚本 #

直接写个简单的shell脚本就能搞定，不管是放在项目根目录，还是加到shell配置里（比如.bashrc/.zshrc）都可以。逻辑大概是这样：

• 读取.python-version里的内容，拆分出Python版本和虚拟环境名
• 检查该版本是否已通过pyenv安装，没装就跑pyenv install <版本号>
• 检查虚拟环境是否存在，不存在就执行pyenv virtualenv <版本号> <环境名>
• 最后用pyenv local <环境名>激活环境

给你个示例脚本（保存成setup-env.sh）：

#!/bin/bash

# 读取文件内容
VERSION_ENV=$(cat .python-version)
# 拆分版本和环境名
PY_VERSION=$(echo "$VERSION_ENV" | cut -d'/' -f1)
ENV_NAME=$(echo "$VERSION_ENV" | cut -d'/' -f3)

# 检查Python版本是否已安装
if ! pyenv versions | grep -q "$PY_VERSION"; then
    echo "正在安装Python $PY_VERSION..."
    pyenv install "$PY_VERSION"
fi

# 检查虚拟环境是否存在
if ! pyenv virtualenvs | grep -q "$ENV_NAME"; then
    echo "正在创建虚拟环境 $ENV_NAME..."
    pyenv virtualenv "$PY_VERSION" "$ENV_NAME"
fi

# 设置并激活本地环境
pyenv local "$ENV_NAME"
echo "虚拟环境 $ENV_NAME 已准备就绪"

用的时候给脚本加执行权限：chmod +x setup-env.sh，克隆项目后跑./setup-env.sh就行。要是想更省心，还可以把这段逻辑做成shell的cd钩子——每次进入有.python-version文件的目录时自动执行。

可选插件的作用 #

有个第三方插件叫pyenv-virtualenv-auto，但它只能自动激活已经存在的虚拟环境，没法帮你自动安装Python版本或者创建新环境，所以还是得配合脚本用。

总结下：想要全自动化完成「安装版本+创建并激活虚拟环境」，必须自己写脚本，pyenv原生和现有插件都做不到一步到位。

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