0. 作業系統為 Raspberry PI OS 64 bit
1. 安裝與設定
# 安裝 pipenv
sudo apt install pipenv
# 建議設定 PIPENV_VENV_IN_PROJECT 環境變數
echo 'export PIPENV_VENV_IN_PROJECT=1' >> ~/.bashrc
source ~/.bashrc
2. 重要注意事項
- 虛擬環境位置
- 設定
PIPENV_VENV_IN_PROJECT=1
可讓虛擬環境建立在專案目錄下 - 預設會建立在
~/.local/share/virtualenvs/
下 - 在專案目錄下建立較易管理,特別是在多個專案間切換時
- 設定
- 效能考量
- 樹莓派效能較低,首次建立虛擬環境可能較慢
- 安裝套件時也會較一般電腦慢
- 建議耐心等待,不要中斷安裝過程
- 常用指令(在專案資料下執行)
# 建立新的虛擬環境
pipenv install
# 指定 Python 版本
pipenv --python 3.9
# 啟動虛擬環境
pipenv shell
# 安裝特定套件
pipenv install package_name
# 安裝開發環境套件
pipenv install --dev package_name
# 查看依賴關係
pipenv graph
# 離開虛擬環境
exit
和 Ctrl + D 都會安全地退出虛擬環境
- 記憶體使用
- 注意套件安裝量,避免過多佔用記憶體
- 可以使用
pipenv clean
清理未使用的套件
- 版本相容性
- 確認套件是否支援 ARM 架構
- 部分套件可能需要額外編譯或不支援樹莓派
- 錯誤處理
- 如遇到安裝錯誤,可嘗試:
pipenv --rm # 移除虛擬環境 pipenv install --skip-lock # 重新安裝但跳過鎖定檔案
- 如遇到安裝錯誤,可嘗試:
- 備份建議
- 保存
Pipfile
和Pipfile.lock
- 這些檔案包含專案的依賴資訊
- 保存
- 系統資源
- 安裝大型套件前檢查可用空間
- 可使用
df -h
查看磁碟空間
- Python 版本
- 明確指定 Python 版本:
pipenv --python 3.9 # 指定 Python 版本
- 明確指定 Python 版本:
- 開發流程建議
- 建立新專案時使用:
mkdir project_name cd project_name pipenv install
- 從既有專案複製時:
git clone <repository> cd <repository> pipenv install
- 建立新專案時使用:
這些注意事項可以幫助您在樹莓派上更順暢地使用 pipenv。如果您有特定的使用情境或遇到問題,歡迎詢問更多細節。