如何为同一项目配置多套Poetry虚拟环境适配不同Git分支？

核心疑问直接解答 #

• 手动维护多份独立命名的poetry.lock副本的方案完全不可取：Poetry默认仅识别项目根目录下固定文件名的poetry.lock，手动备份多份不同分支对应的lock文件，每次切换分支都需要手动执行文件替换操作，不仅操作繁琐，还很容易出现环境、lock文件、依赖版本三者不匹配的问题，和conda的零手动切换体验差距极大。

可复现conda使用体验的原生实现逻辑 #

不需要依赖自定义脚本或者第三方工具，完全可以基于Poetry原生配置实现「同项目不同Git分支自动绑定独立虚拟环境、无感知切换」的效果，具体操作如下：

1. 调整Poetry虚拟环境的命名规则
   修改全局配置，让Poetry生成虚拟环境时，自动把当前Git分支名作为环境名的一部分，从根源上避免不同分支共用同一个虚拟环境的问题，执行以下命令即可完成配置：

   poetry config virtualenvs.path "{cache-dir}/virtualenvs/{project_slug}-{git_branch}"
   

   该配置为全局生效，所有由Poetry管理的项目，都会自动按当前所在Git分支生成独立的虚拟环境，无需为单个项目重复配置。
2. 匹配日常使用流程
   每个项目分支在首次拉取后，只需要在分支根目录执行一次poetry install，就会自动生成当前分支专属的独立虚拟环境。
   后续在这个分支下执行poetry run、poetry shell等操作时，Poetry会自动识别当前所在的Git分支，关联到对应的专属虚拟环境，不需要手动执行激活/停用操作，切换Git分支时也不需要手动切换环境，和conda的使用体验完全一致。

操作注意事项 #

• 不需要额外管理多份lock文件：每个Git分支本身会随版本控制提交对应分支专属的pyproject.toml和poetry.lock，切换分支时这两个文件会自动同步更新，Poetry会自动匹配对应分支锁定的依赖版本，完全不需要手动复制、备份多份lock文件。
• 可以随时校验当前关联的环境：执行poetry env info即可直接看到当前分支匹配的虚拟环境路径，确认无不同分支的环境串扰问题。

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