Windows系统PyCharm新建项目Poetry环境配置失败

排查与修复步骤 #

• 核对PyCharm的Poetry配置
  打开File > Settings > Tools > Poetry：
  • 确认Poetry executable指向正确的poetry.exe（一般在%APPDATA%\Python\Scripts\poetry.exe，或者你手动安装的路径）
  • Python interpreter选系统里的Python 3.11.5主程序，别选虚拟环境里的路径
• 手动建Poetry环境再导入PyCharm
  1. 开CMD，切到新项目目录
  2. 执行poetry env use python3.11（PATH里没Python3.11的话，直接写完整路径，比如C:\Python311\python.exe）
  3. 跑poetry install初始化环境
  4. 回到PyCharm，进入File > Settings > Project: [你的项目名] > Python Interpreter，点齿轮选Add，再选Existing environment，找到Poetry生成的虚拟环境（路径一般是%USERPROFILE%\AppData\Local\pypoetry\Cache\virtualenvs\下对应项目文件夹里的Scripts\python.exe）
• 让Poetry把虚拟环境放在项目目录里
  执行poetry config virtualenvs.in-project true，这样虚拟环境会建在项目根目录的.venv文件夹，PyCharm更容易识别，之后重新执行poetry env use python3.11和poetry add pandas
• 检查系统PATH与权限
  • 把Python 3.11.5的安装路径（C:\Python311和C:\Python311\Scripts）移到系统PATH最前面，避免其他版本Python干扰
  • 右键PyCharm选以管理员身份运行，再尝试配置环境，排除权限限制问题
• 清空PyCharm缓存
  点击File > Invalidate Caches...，勾选Clear file system cache and local history，重启PyCharm后再重新配置环境

验证方法 #

完成上述步骤后，在PyCharm终端执行poetry --version和python --version确认版本正确，再执行poetry add pandas测试是否能正常运行。

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