You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Windows+WSL2环境下如何在PyCharm中配置Poetry虚拟环境?

问题原因

你操作的核心误区是:Windows端PyCharm配置WSL侧的Poetry环境时,不能直接通过Windows的网络路径\\wsl$填写Poetry环境路径,Poetry插件默认是读取当前系统(Windows)的文件路径,无法正确识别WSL侧的Linux可执行文件。

正确操作步骤
  • 第一步:进入Add Python Interpreter界面后,先在左侧列表选择WSL,不是直接选Poetry Environment,等待PyCharm加载WSL发行版(你的情况选Ubuntu-20.04),确认WSL连通正常。
  • 第二步:加载完成后在同一界面左侧切换选择Poetry Environment,此时PyCharm会自动读取WSL侧的Poetry配置,不要手动填Windows下的\\wsl$路径,直接在Existing environment的下拉列表里就能看到你已经创建好的Poetry虚拟环境。
  • 第三步:如果下拉列表没自动识别到,就手动填WSL侧的Linux格式路径,也就是你在WSL终端里执行poetry env info -p输出的路径拼接/bin/python,格式为/home/$USER/.cache/pypoetry/virtualenvs/my-pretty-project-<some-hash>-py3.8/bin/python,不要转成Windows的\\wsl$路径。
  • 第四步:确认路径后点击确认,等待PyCharm加载环境的包索引即可。
兼容适配检查项
  • 先在WSL终端执行poetry --version确认Poetry已经正确安装在WSL用户的PATH下,不要仅在Windows端安装Poetry
  • 确保PyCharm的WSL工具链配置正常:进入File > Settings > Build, Execution, Deployment > Toolchains,确认已经添加了WSL的Ubuntu-20.04工具链,且验证通过
  • 2021.3版本的第三方Poetry插件存在WSL适配bug,如果上述操作无效,可以升级PyCharm到2022.2及以上版本,该版本已经原生集成Poetry+WSL适配,不需要额外安装第三方Poetry插件

内容的提问来源于stack exchange,提问作者aon

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.24 10:24:03