Skip to content

在 Pycharm 配置 Poetry 環境

原文: Configure a Poetry environment

Poetry 是一個有助於根據專案依賴關係建立 Python 虛擬環境的工具。您可以聲明您的專案所依賴的程式庫,Poetry 將為您安裝和更新它們。

專案依賴項記錄在 pyproject.toml 檔案中,該檔案指定所需的套件、腳本、外掛程式和 URL。有關其結構和格式的更多信息,請參閱 pyproject 參考

要在 PyCharm 中使用 Poetry,您需要將其安裝在您的電腦上並建立特定的 Python 環境。

安裝 Poetry

  1. 開啟終端機(在 macOS 和 Linux 上)或 PowerShell(在 Windows 上)並執行下列命令:
curl -sSL https://install.python-poetry.org | python3 -
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
curl -sSL https://install.python-poetry.org | python3 -
  1. 在 macOS 和 Windows 上,安裝腳本會建議將包含 Poetry 可執行檔的資料夾新增至 PATH 變數。透過執行以下命令來執行此操作:
export PATH="/Users/jetbrains/.local/bin:$PATH"
$Env:Path += ";C:\Users\jetbrains\AppData\Roaming\Python\Scripts"; setx PATH "$Env:Path"

不要忘記用您的用戶名替換 jetbrains

  1. 若要驗證安裝,請執行以下命令:
poetry --version

您應該會看到類似 Poetry(版本 1.2.0)的內容。

有關更多信息,請參閱 Poetry 安裝說明

創建 Poetry environment

  1. 執行下列操作之一:

    • 點選 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 連結。
  2. 選擇 Add Local Interpreter

  3. 在左側窗格中 Add Python Interpreter, 選擇 Poetry Environment

  1. 以下操作取決於您是要建立新的 Poetry 環境還是使用現有環境。
  • 選擇 Poetry Environment。
  • 從清單中選擇基本解釋器,或按一下選擇基本解釋器並在檔案系統中找到所需的 Python 執行檔。
  • 如果您的專案包含 pyproject.toml,您可以透過啟用或停用從 pyproject.toml 安裝軟體包複選框來選擇是否要安裝其中列出的軟體包。預設情況下,該複選框處於啟用狀態。
  • 如果 PyCharm 未偵測到 Poetry 可執行文件,請在對話方塊中指定下列路徑,並將 jetbrains 替換為您的使用者名稱:
/Users/jetbrains/Library/Application Support/pypoetry/venv/bin/poetry
C:\Users\jetbrains\AppData\Roaming\pypoetry\venv\Scripts\poetry.exe
/home/jetbrains/.local/bin/poetry
  • 確保專案目錄包含 pyproject.toml 檔案。
  • 選擇 Existing environment。 然後展開 Interpreter 列垃并選擇想要使用的 interpreter。
  • 如果所需的 Interpreter 不在清單中,請按一下 ,然後在先前設定的 Poetry 環境中瀏覽以尋找 Python 執行檔。

所選的 Poetry 環境將在目前專案中重複使用。

  1. 按一下 OK 完成任務。