Windows下Poetry env use无法识别指定Python版本的问题求助

问题现象 #

• 已安装Python3.7（全局默认）和3.10版本，Poetry 1.4.1配置正常
• 执行命令poetry env use C:\Users\Foo\AppData\Local\Programs\Python\Python310\python.exe时，提示指定的Python版本3.7.2不符合项目^3.10的约束，但直接运行该路径的Python可显示版本为3.10.2
• 系统Path已包含Python3.10路径，但Get-Command python仍指向全局3.7版本，重启终端、VSCode及系统后问题依旧
• 通过VSCode选择Python3.10解释器后，终端内Poetry可正常工作，但设置poetry config virtualenvs.in-project true后，无法在项目目录创建本地.venv环境
• 临时解决方法：复制已有Poetry环境到项目目录并重命名为.venv

问题原因 #

• Windows环境变量Path优先级问题：Python3.10路径在Path中位置靠后，导致全局python命令仍优先调用3.7版本
• Poetry缓存了旧的Python版本信息，或者对指定路径的解析出现异常
• 多Python版本共存时，环境隔离机制未生效，导致Poetry误读取全局版本信息

解决方法 #

方法1：调整Path优先级 #

1. 打开系统环境变量设置，找到Path系统变量
2. 将Python3.10的安装路径（C:\Users\Foo\AppData\Local\Programs\Python\Python310\）及其Scripts子路径（C:\Users\Foo\AppData\Local\Programs\Python\Python310\Scripts\）移至Path列表最顶端
3. 重启终端，执行Get-Command python确认已指向3.10版本，再重新执行poetry env use C:\Users\Foo\AppData\Local\Programs\Python\Python310\python.exe

方法2：清理Poetry缓存与旧环境 #

1. 执行命令清理Poetry全局缓存：

   poetry cache clear --all pypi
   

2. 删除项目目录下的poetry.lock文件及已存在的.venv目录
3. 执行命令删除所有关联的虚拟环境：

   poetry env remove --all
   

4. 重新指定Python3.10环境并安装依赖：

   poetry env use C:\Users\Foo\AppData\Local\Programs\Python\Python310\python.exe
   poetry install
   

方法3：彻底重装（根治方案） #

1. 卸载所有已安装的Python版本，删除残留的虚拟环境文件夹及Poetry配置文件
2. 采用单用户安装方式重新安装Python3.10（避免全局权限冲突）
3. 重新安装Poetry，确保安装过程中关联到Python3.10
4. 重新初始化项目并配置环境

VSCode环境临时适配 #

如果不想调整全局环境，可按以下步骤操作：

1. 打开项目后，点击VSCode左下角的解释器选择器，切换到Python3.10
2. 打开新的终端（确保终端继承VSCode的解释器环境）
3. 执行poetry config virtualenvs.in-project true后，手动在项目根目录创建.venv文件夹，再执行poetry install触发环境创建

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