如何使用pyenv在项目内创建可提交版本控制的本地env虚拟环境

你此前设想的「先通过pyenv切换到目标Python版本，再在项目目录内创建虚拟环境」的方案完全可行，按以下步骤操作即可：

• 进入项目根目录，将当前目录的Python版本绑定为已安装的3.8.4：

  pyenv local 3.8.4
  

  执行后项目根目录会自动生成.python-version配置文件，该文件可提交到版本库，其他安装了pyenv的协作者进入项目目录时会自动切换到匹配的Python版本。
• 校验版本是否生效：

  python3 --version
  # 确认输出为 Python 3.8.4
  which python3
  # 确认输出路径包含.pyenv/shims，而非系统默认的/usr/bin/python3
  

• 直接在项目根目录生成本地虚拟环境文件夹：

  python3 -m venv env
  

  最终生成的env文件夹完全基于pyenv管理的Python 3.8.4创建，存放在项目目录内，激活、安装依赖的使用逻辑和你之前用virtualenv的体验完全一致。

强烈不建议将整个env文件夹提交到版本控制系统：虚拟环境内包含与当前操作系统、CPU架构、本地文件路径强绑定的二进制文件，你在Ubuntu 22上生成的env，其他用户在MacOS、Windows甚至其他Linux发行版上拉取后都无法正常运行，反而会提升协作成本。
推荐的版本控制配置方式：

• 在.gitignore中添加env/规则，忽略整个虚拟环境目录
• 提交.python-version文件，统一项目要求的Python大版本/小版本号
• 提交通过pip freeze > requirements.txt生成的依赖清单
• 协作者克隆仓库后，仅需3行命令即可完成环境初始化：

  pyenv install 3.8.4 # 首次运行需安装对应Python版本
  python3 -m venv env
  source env/bin/activate && pip install -r requirements.txt
  

如果你因特殊场景必须提交项目内的虚拟环境文件夹，上述步骤生成的env目录本身就位于项目根路径，直接删除.gitignore中对应的忽略规则即可提交，无需额外配置。

你之前操作时生成的虚拟环境默认存放在~/.pyenv/versions路径，是pyenv-virtualenv插件的默认全局环境存储逻辑，这类全局环境适合多项目复用同一套依赖的场景，不适合放在项目目录内随仓库提交。

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