樹莓派下使用 pipenv 注意細節

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. 重要注意事項

  1. 虛擬環境位置
    • 設定 PIPENV_VENV_IN_PROJECT=1 可讓虛擬環境建立在專案目錄下
    • 預設會建立在 ~/.local/share/virtualenvs/
    • 在專案目錄下建立較易管理,特別是在多個專案間切換時
  2. 效能考量
    • 樹莓派效能較低,首次建立虛擬環境可能較慢
    • 安裝套件時也會較一般電腦慢
    • 建議耐心等待,不要中斷安裝過程
  3. 常用指令(在專案資料下執行)
# 建立新的虛擬環境
pipenv install

# 指定 Python 版本
pipenv --python 3.9  

# 啟動虛擬環境
pipenv shell

# 安裝特定套件
pipenv install package_name

# 安裝開發環境套件
pipenv install --dev package_name

# 查看依賴關係
pipenv graph

# 離開虛擬環境
exit 
和 Ctrl + D 都會安全地退出虛擬環境
  1. 記憶體使用
    • 注意套件安裝量,避免過多佔用記憶體
    • 可以使用 pipenv clean 清理未使用的套件
  2. 版本相容性
    • 確認套件是否支援 ARM 架構
    • 部分套件可能需要額外編譯或不支援樹莓派
  3. 錯誤處理
    • 如遇到安裝錯誤,可嘗試: pipenv --rm # 移除虛擬環境 pipenv install --skip-lock # 重新安裝但跳過鎖定檔案
  4. 備份建議
    • 保存 PipfilePipfile.lock
    • 這些檔案包含專案的依賴資訊
  5. 系統資源
    • 安裝大型套件前檢查可用空間
    • 可使用 df -h 查看磁碟空間
  6. Python 版本
    • 明確指定 Python 版本: pipenv --python 3.9 # 指定 Python 版本
  7. 開發流程建議
    • 建立新專案時使用: mkdir project_name cd project_name pipenv install
    • 從既有專案複製時: git clone <repository> cd <repository> pipenv install

這些注意事項可以幫助您在樹莓派上更順暢地使用 pipenv。如果您有特定的使用情境或遇到問題,歡迎詢問更多細節。

發佈留言