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]上支援問題,讓我們一起推動問題的解決。