在 Windows 上安裝 Poetry 的詳細指南

更新日期： 2024 年 11 月 23 日

Poetry 是一個強大的 Python 套件管理工具，能夠簡化專案的相依性管理和打包流程。

在 Windows 系統上，透過一系列工具的組合，我們可以順利地安裝並使用 Poetry。

本文將以新手角度，詳細介紹在 Windows 上安裝 Poetry 的步驟，並解釋相關工具的用途與差異。

安裝流程概覽：

1. 安裝 Scoop
2. 使用 Scoop 安裝 pipx
3. 確保路徑設定正確
4. 使用 pipx 安裝 Poetry

接下來，我們將逐步講解每個步驟。

安裝 Scoop

什麼是 Scoop？

Scoop 是一個適用於 Windows 的命令列套件管理工具，旨在簡化軟體的安裝和管理。

透過 Scoop，您可以在命令列中輕鬆安裝、更新和移除各種應用程式，類似於 Linux 上的包管理器，如 apt 或 yum。

安裝 Scoop 的步驟

1. 開啟 PowerShell：
   • 按下 Win + X，選擇「Windows PowerShell」或「Windows PowerShell (管理員)」。
   • 建議以管理員身份運行，以避免權限問題。

2. 設定執行政策：

• 在 PowerShell 中輸入以下命令，允許執行遠端簽署的腳本：

 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

3. 安裝 Scoop：
   • 執行以下命令以安裝 Scoop：

iwr -useb get.scoop.sh | iex

4. 驗證安裝：
   • 安裝完成後，輸入以下命令確認 Scoop 是否安裝成功：
   • 如果顯示版本號，表示安裝成功。

 scoop --version

使用 Scoop 安裝 pipx

什麼是 pipx？

pipx 是一個專門用於安裝和管理 Python 命令列工具的工具。

它能夠將這些工具安裝在獨立的虛擬環境中，避免與其他 Python 套件發生衝突。

安裝 pipx 的步驟

1. 使用 Scoop 安裝 pipx：
   • 在 PowerShell 中輸入以下命令：

scoop install pipx

2. 確保路徑設定正確：
   • 安裝完成後，執行以下命令以確保 pipx 的路徑已添加到系統的 PATH 中：
   • 執行此命令後，請重新啟動 PowerShell 以使路徑設定生效。

 pipx ensurepath

使用 pipx 安裝 Poetry

1. 安裝 Poetry：
   • 在 PowerShell 中輸入以下命令：

pipx install poetry

2. 驗證安裝：
   • 安裝完成後，輸入以下命令確認 Poetry 是否安裝成功：
   • 如果顯示版本號，表示安裝成功。

poetry --version

Scoop 與 Chocolatey 的差異

Scoop 和 Chocolatey 都是 Windows 平台上的套件管理工具，但它們在設計理念和使用方式上有所不同。

• 安裝位置與權限：
  • Scoop： 預設將軟體安裝在使用者主目錄下，無需管理員權限即可安裝，避免了 UAC（使用者帳戶控制）的彈出提示。
  • Chocolatey： 通常將軟體安裝在系統層級的目錄中，需要管理員權限，安裝過程中可能會出現 UAC 提示。
• 套件來源與數量：
  • Scoop： 專注於開源的命令列工具，透過「桶（Bucket）」的概念來管理套件來源。
    
    使用者可以添加不同的 Bucket 以擴充可用套件的範圍。
  • Chocolatey： 擁有龐大的套件庫，涵蓋各種常用軟體，包括圖形介面的應用程式。
• 相依性管理：
  • Scoop： 強調安裝獨立的可攜式應用程式，避免修改系統設定，減少相依性問題。
  • Chocolatey： 能處理複雜的相依性，適合安裝需要多個相依套件的應用程式。

注意事項

• 以管理員身份運行： 在安裝 Scoop 和 pipx 時，建議以管理員身份運行 PowerShell，以避免可能的權限問題。
• 環境變數設定： 安裝完成後，確保相關工具的路徑已正確添加到系統的 PATH 環境變數中。

透過上述步驟，您應該能夠在 Windows 系統上順利安裝並使用 Poetry。