dbus-python 手動編譯安裝教學：解決依賴缺失與配置錯誤

dbus-python 是 Python 與 D-Bus 訊息總整合的橋樑，常用於進程間通訊（IPC）。因官方未提供 setup.py，無法透過 pip 直接安裝，需從原始碼手動編譯。本文記錄完整安裝流程與常見錯誤排解。

下載與解壓原始碼

wget https://pypi.python.org/packages/source/d/dbus-python/dbus-python-0.84.0.tar.gz
tar zxvf dbus-python-0.84.0.tar.gz
cd dbus-python-0.84.0

常見配置錯誤：缺少 dbus-1 開發套件

執行 ./configure 時可能遇到：

configure: error: Package requirements (dbus-1 >= 1.0) were not met:
 No package 'dbus-1' found

原因是系統缺少 D-Bus 開發標頭檔與庫檔。

解決方案：安裝相依套件

Ubuntu/Debian 系統：

sudo apt-get install libdbus-glib-1-dev

CentOS/RHEL 系統：

sudo yum install dbus-glib-devel

編譯與安裝

依賴解決後，依序執行：

./configure
make
sudo make install

驗證安裝

python -c "import dbus; print(dbus.__version__)"

應用場景

• Linux 桌面應用與系統服務通訊（如 NetworkManager、systemd）
• 進程間事件通知與資料交換
• 硬體裝置監控與控制（藍牙、USB 熱插拔等）

注意事項

• 確保 Python 開發套件（python-dev）已安裝
• 若使用 virtualenv，需在虛擬環境中編譯安裝
• 部分發行版套件庫已提供預編譯套件（如 python-dbus），優先考慮套件管理器安裝