【笔记】PyCharm 2025.2 EAP 创建 Poetry 和 Hatch 环境的踩坑实录与反馈
https://youtrack.jetbrains.com/issue/PY-82407/Incorrect-Python-Version-and-Virtual-Environment-Path-When-Creating-Poetry-and-Hatch-Environments-via-GUI-in-PyCharm-2025.2-EAP
在 Python 开发的道路上,PyCharm 一直是我们信赖的开发利器。然而,最近在使用 PyCharm 2025.2 EAP 版本时,却遇到了令人头疼的问题。为了找到问题根源,我们投入了大量时间和精力,经过无数次测试与验证,终于确认这并非系统环境变量设置的 “锅”,而是 PyCharm 软件本身存在的缺陷。在这里,我们将整个过程详细记录下来,希望能给遇到类似问题的开发者一些参考。
一、问题初现
当我们尝试在 PyCharm 2025.2 EAP 中,通过图形界面(GUI)创建 Poetry 和 Hatch 虚拟环境时,诡异的现象接连出现。在创建 Poetry 环境时,明明指定了 Python 3.11 作为基础解释器,创建完成后却发现环境使用的是 Python 3.12;而创建 Hatch 环境时,环境并没有如预期般创建在项目目录内,反而 “跑” 到了全局路径中。这让我们不禁怀疑,是哪里出了问题?
二、抽丝剥茧:排除环境变量的嫌疑
面对这些问题,我们首先将怀疑的目光投向了系统环境变量。毕竟,环境变量设置不当常常会导致软件无法正确识别路径和版本。于是,我们开始了漫长而细致的排查工作。
我们反复检查了 Python 安装路径、Poetry 和 Hatch 的安装路径在环境变量中的配置,确保路径准确无误。同时,我们还尝试修改环境变量的顺序,以排除优先级问题的影响。为了进一步验证,我们在命令行中直接使用 Poetry 和 Hatch 创建虚拟环境,结果显示一切正常,环境能够按照预期创建,且 Python 版本和路径都准确无误。这就明确表明,系统环境变量的设置并没有问题。
接下来,我们又对 PyCharm 的相关配置进行了深入检查。我们重新安装了 PyCharm 2025.2 EAP,确保没有配置残留的干扰。在安装过程中,我们仔细核对每一个选项,确保安装路径和配置参数都符合要求。安装完成后,我们再次尝试创建 Poetry 和 Hatch 环境,问题依旧存在。这一系列的测试和验证,让我们最终确定,问题的根源在于 PyCharm 2025.2 EAP 本身。
三、问题重现与详细描述
(一)Poetry 环境创建问题
- 打开 PyCharm,创建或打开一个 Python 项目。
- 进入File > Settings > Project > Python Interpreter,点击添加新解释器。
- 在弹出的窗口中,选择Poetry Environment,指定 Python 3.11 作为 Base Interpreter,并设置本地 Poetry 路径,同时勾选 “在项目目录内创建环境” 选项。
- 点击确认后,创建完成的 Poetry 环境使用的却是 Python 3.12,并且环境路径不在项目目录内,而是位于项目目录之外的全局路径中。
Poetry 环境创建出错(Python 版本出错):

(二)Hatch 环境创建问题
- 同样在 Python Interpreter 设置中,选择Hatch Environment。
- 指定本地 Hatch 路径和 Python 3.11 版本,将工作目录设置为项目根目录。
- 确认创建后,Hatch 环境并没有如预期般创建在项目的.venv文件夹内,而是被创建在了全局缓存路径(如C:\Users\<user>\AppData\Local\hatch\env)中。
Hatch 环境创建出错(环境位置出错)
四、问题反馈与进展
在确认是 PyCharm 软件的问题后,我们通过官方渠道提交了反馈(问题编号:PY-82407)。目前,该问题已被标记为Bug,状态为Submitted(已提交),但尚未分配负责人。官方对问题的子系统定位也在不断调整,从最初的 “无” 到Interpreters Settings(解释器设置),再到Core. Run. Targets(核心运行目标),这表明官方正在积极排查问题涉及的模块。
虽然目前还没有得到官方的解决方案,但我们会持续关注问题的进展,并及时更新本文。希望官方能够尽快修复这些问题,让 PyCharm 2025.2 EAP 能够恢复往日的 “战斗力”。
五、结语
这次踩坑经历让我们深刻体会到,在遇到问题时,不能轻易下结论,需要通过严谨的测试和验证来找到问题的根源。同时,也希望我们的这篇笔记能够帮助到其他遇到类似问题的开发者,少走一些弯路。如果你在使用 PyCharm 2025.2 EAP 过程中也遇到了相关问题,欢迎在评论区留言交流或在[YouTrack]上支援问题,让我们一起推动问题的解决。