ServBay 中 pip 使用指南

pip 是 Python 語言官方推薦的套件管理工具，也是 Python 生態系統中不可或缺的一環。ServBay 作為專為開發者設計的本地 Web 開發環境，深度整合了對 Python 及其套件管理工具 pip 的支持，極大簡化了 Python 專案的建置以及依賴管理流程。

本指南旨在協助 ServBay 用戶了解並高效使用 pip 來管理 Python 軟體套件，無論是安裝新函式庫、升級現有依賴，還是在隔離環境中進行開發。

什麼是 pip？

pip 是用於安裝和管理 Python 模組（套件）的工具。它能夠從 Python Package Index (PyPI) 或其他來源下載和安裝所需軟體包。

發展歷史與重要性：
- pip 首次於 2008 年發佈，作為 easy_install 的升級替代方案。
- 自 Python 3.4 起，pip 被預設包含在 Python 的標準安裝包中，成為實質上的標準套件管理器。
- 通過 pip，開發者可輕鬆安裝、升級、移除並管理專案所需的第三方函式庫與框架。
核心功能概覽：
- 安裝套件：自 PyPI 或其他索引源下載及安裝 Python 套件及其相依模組。
- 依賴管理：可記錄專案所需所有套件與版本，並據此重建開發／佈署環境（通常透過 requirements.txt）。
- 版本控制：支援安裝特定版本的套件，協助處理套件間依賴與潛在版本衝突。
- 多元安裝來源：支援自 PyPI、版本控制系統（如 Git）、本機路徑或發佈檔案安裝。
ServBay 與 pip 的整合：
- ServBay 預先安裝了其內建 Python 版本所對應的最新穩定版 pip。
- ServBay 的套件管理與內建 pip 無縫協作，帶來流暢的安裝體驗。
- ServBay 支援您在各版本 Python 環境下獨立安裝及管理套件。

前置條件

開始於 ServBay 使用 pip 前，請確認：

您已順利安裝並啟動 ServBay。
至少已在 ServBay 中啟用一個 Python 版本套件。

ServBay 中 pip 的基本操作

ServBay 已預載 pip 於其提供的 Python 環境中，您可直接透過終端機使用 pip，無需額外安裝。

打開終端視窗，並執行下列命令：

常用命令範例

安裝套件：
bash
```
pip install 套件名稱
```
1
例如，安裝熱門 Web 框架 Flask：
bash
```
pip install Flask
```
1
安裝指定版本套件：
bash
```
pip install 套件名稱==版本號
```
1
例如，安裝 Flask 2.0.0 版本：
bash
```
pip install Flask==2.0.0
```
1

升級套件：

bash

pip install --upgrade 套件名稱

例如，將 Flask 升級至最新版：

bash

pip install --upgrade Flask

移除套件：
bash
```
pip uninstall 套件名稱
```
1
移除 Flask：
bash
```
pip uninstall Flask
```
1
執行這個指令後，pip 會列出將刪除的檔案並要求您確認。
列出已安裝套件：
bash
```
pip list
```
1
此命令會列出當前環境下所有已安裝套件及其版本。
檢查可更新的套件：
bash
```
pip list --outdated
```
1
此命令可協助確認有無更新版的已安裝套件。

pip 進階操作與依賴管理

在實際開發專案時，經常需要更進階的 pip 功能來管理依賴。

生成專案依賴檔 (requirements.txt)：為紀錄目前專案所需套件及精確版本，可使用 pip freeze 指令。這對確保開發、測試與生產環境一致性至關重要。
bash
```
pip freeze > requirements.txt
```
1
這個指令會將現有 Python 環境下所有 pip 安裝的套件輸出到 requirements.txt 檔案。
根據 requirements.txt 安裝依賴：若您獲得一個含有 requirements.txt 的專案，透過這個檔案即可快速安裝全部依賴。
bash
```
pip install -r requirements.txt
```
1
pip 會讀取檔案並依內容批次安裝所有指定套件及版本。
指定鏡像源安裝（暫時有效）：某些網路環境下直接從 PyPI 下載速度緩慢或不穩定，您可透過 -i 參數暫時指定其他 PyPI 鏡像。
bash
```
pip install 套件名稱 -i https://pypi.tuna.tsinghua.edu.cn/simple
```
1
請注意，此方式僅對當前指令有效。若需永久修改鏡像，請參考設定 pip 全域鏡像源。

虛擬環境（Virtual Environments）

強烈建議進行 Python 專案開發時善用虛擬環境。虛擬環境是獨立的 Python 執行環境，擁有自己的 Python 直譯器、pip 和獨立的 site-packages 專案庫。其優點包含：

依賴隔離：不同專案可依賴同一庫的不同版本，互不干擾。
保持系統環境乾淨：避免在全域環境累積大量專案相依套件。
簡化依賴管理：更方便利用 pip freeze 產生精確依賴清單。

在 ServBay 中建立與使用虛擬環境

ServBay 環境一般均內建 venv 模組（Python 3.3+ 內置）或可安裝 virtualenv 工具，建議優先使用內建的 venv。

建立虛擬環境：假設您的專案目錄為 /Applications/ServBay/www/my-python-project，請於該資料夾執行下列命令：
bash
```
cd /Applications/ServBay/www/my-python-project
python -m venv myenv
```
1
2
將會在當前目錄下建立名為 myenv 的資料夾，其中即為新的 Python 環境。
啟動虛擬環境：使用虛擬環境前，需先啟動。啟動後，您於該終端機視窗執行的 python 及 pip 指令皆指向虛擬環境版本。
- macOS/Linux 系統：
  bash
```
source myenv/bin/activate
```
  1
- Windows 系統（經 ServBay 或其他兼容終端）：
  bash
```
myenv\Scripts\activate
```
  1
啟動後，終端命令提示符會顯示虛擬環境名稱（如 (myenv) your_prompt$）。
於虛擬環境中安裝套件：啟動虛擬環境後，直接透過 pip 安裝套件，會安裝到該虛擬環境的 site-packages 下。
bash
```
(myenv) pip install requests
```
1
這樣安裝的 requests 套件僅作用於 myenv 虛擬環境，不會影響系統其他環境。
離開虛擬環境：完成在虛擬環境中的作業後，可執行以下指令離開：
bash
```
deactivate
```
1
此後您的終端提示符會恢復正常，python 及 pip 指令又將指向系統／全域環境。

最佳實踐建議

務必於虛擬環境中使用 pip：這應成為所有 Python 開發的基本原則之一。
運用 requirements.txt 管理專案依賴：定期以 pip freeze > requirements.txt 更新依賴檔，並將其納入版本控制。
定期升級 pip：儘管 ServBay 已提供新版本 pip，建議仍於虛擬環境或全域環境間定期升級 pip：pip install --upgrade pip。
檢查與更新過時套件：利用 pip list --outdated 檢視可更新套件，並依專案需求適時升級。
熟悉常見問題：若安裝出現錯誤，請仔細閱讀錯誤提示。常見狀況包含網路異常、權限問題、依賴衝突或缺少建構工具等。

常見問題解答 (FAQ)

問：在 ServBay 終端輸入 pip 發現顯示找不到指令怎麼辦？
- 答：請確認已在 ServBay 啟用 Python 套件，並檢查 ServBay 的環境變數設定正確。
問：安裝套件速度慢或失敗？
- 答：多半為網路因素。建議利用 -i 參數指定效能佳的 PyPI 鏡像源，或參考設定 pip 全域鏡像源。
問：安裝某些套件出現權限錯誤（Permission Denied）？
- 答：請勿在全域系統環境下用 sudo pip install ...。強烈建議於虛擬環境操作，您將擁有完整寫入權限。如確需安裝到用戶全域（不建議），可選用 pip install --user 套件名稱。

總結

ServBay 為 Python 開發者提供了便利且整合的開發環境，其中內含功能完善的 pip 工具。熟練掌握 pip 基本與進階操作，特別是搭配虛擬環境運用，讓您能高效管理專案依賴、避免環境衝突，更專注於開發本身。善用 ServBay 與 pip 的結合，能大幅提升您的 Python 開發工作流程效率。

ServBay 中 pip 使用指南 ​

什麼是 pip？ ​

前置條件 ​

ServBay 中 pip 的基本操作 ​

常用命令範例 ​

pip 進階操作與依賴管理 ​

虛擬環境（Virtual Environments） ​

在 ServBay 中建立與使用虛擬環境 ​

最佳實踐建議 ​

常見問題解答 (FAQ) ​

總結 ​