Ubuntu 系統安裝 python-dateutil 套件的正確姿勢

錯誤現象

在 virtualenv 環境下執行 Python 程式報 ImportError: No module named dateutil。嘗試 python setup.py install 與 pip install python-dateutil 均失敗，pip 甚至拋出 IndexError: list index out of range。

推薦安裝步驟

1. 優先使用系統套件管理器（適用於系統級 Python 或已啟用 system-site-packages 的虛擬環境）：

   sudo apt-get update
   sudo apt-get install python3-dateutil  # Python 3
   # 或
   sudo apt-get install python-dateutil   # Python 2
   

2. 虛擬環境中使用 pip（確保 pip 版本較新）：

   # 升級 pip
   pip install --upgrade pip
   # 安裝
   pip install python-dateutil
   

3. 手動編譯安裝（最後手段）：

   tar -xzf python-dateutil-*.tar.gz
   cd python-dateutil-*
   python setup.py install
   

   無需指定 --install-path，setup.py 會自動安裝至當前 Python 環境的 site-packages。

常見坑點

• pip 版本過舊導致解析依賴失敗（升級 pip 即可）。
• 虛擬環境未啟用或啟用錯誤，導致安裝到系統 Python 而非虛擬環境。
• 網路問題導致下載不完整，可嘗試 pip install --no-cache-dir python-dateutil。

遵循「系統套件優先、pip 次之、手動編譯最後」的順序，可避開絕大多數安裝問題。