在 Pycharm 配置 Poetry 環境¶
原文: Configure a Poetry environment
Poetry 是一個有助於根據專案依賴關係建立 Python 虛擬環境的工具。您可以聲明您的專案所依賴的程式庫,Poetry 將為您安裝和更新它們。
專案依賴項記錄在 pyproject.toml
檔案中,該檔案指定所需的套件、腳本、外掛程式和 URL。有關其結構和格式的更多信息,請參閱 pyproject 參考。
要在 PyCharm 中使用 Poetry,您需要將其安裝在您的電腦上並建立特定的 Python 環境。
安裝 Poetry¶
- 開啟終端機(在 macOS 和 Linux 上)或 PowerShell(在 Windows 上)並執行下列命令:
- 在 macOS 和 Windows 上,安裝腳本會建議將包含 Poetry 可執行檔的資料夾新增至 PATH 變數。透過執行以下命令來執行此操作:
不要忘記用您的用戶名替換 jetbrains
!
- 若要驗證安裝,請執行以下命令:
您應該會看到類似 Poetry(版本 1.2.0)的內容。
有關更多信息,請參閱 Poetry 安裝說明。
創建 Poetry environment¶
-
執行下列操作之一:
- 點選 Python Interpreter selector 并且選擇 Add New Interpreter。
- Press
Ctrl
+Alt
+S
to open Settings and go to Project:| Python Interpreter . Click the Add Interpreter 連結。 - 點選 Python Interpreter selector 并且選擇 Interpreter Settings. 點選 Add Interpreter 連結。
-
選擇 Add Local Interpreter。
- 在左側窗格中 Add Python Interpreter, 選擇 Poetry Environment。
- 以下操作取決於您是要建立新的 Poetry 環境還是使用現有環境。
- 選擇 Poetry Environment。
- 從清單中選擇基本解釋器,或按一下選擇基本解釋器並在檔案系統中找到所需的 Python 執行檔。
- 如果您的專案包含 pyproject.toml,您可以透過啟用或停用從 pyproject.toml 安裝軟體包複選框來選擇是否要安裝其中列出的軟體包。預設情況下,該複選框處於啟用狀態。
- 如果 PyCharm 未偵測到 Poetry 可執行文件,請在對話方塊中指定下列路徑,並將 jetbrains 替換為您的使用者名稱:
- 確保專案目錄包含
pyproject.toml
檔案。 - 選擇 Existing environment。 然後展開 Interpreter 列垃并選擇想要使用的 interpreter。
- 如果所需的 Interpreter 不在清單中,請按一下 ,然後在先前設定的 Poetry 環境中瀏覽以尋找 Python 執行檔。
所選的 Poetry 環境將在目前專案中重複使用。
- 按一下 OK 完成任務。