解決 ImageMagick 安裝錯誤：error while loading shared libraries

ImageMagick 安裝常見錯誤與解決方案

安裝 ImageMagick 後執行指令出現：

./tests: error while loading shared libraries: xxx.so.0: cannot open shared object file: No such file or directory

表示動態連結器找不到共用函式庫位置。

解決步驟

1. 編輯動態連結器設定：

   vim /etc/ld.so.conf

   加入函式庫路徑（通常為 /usr/local/lib）：

   /usr/local/lib

2. 更新快取：

   /sbin/ldconfig -v

   此步驟必須執行，否則設定不生效。
3. 驗證：

   convert -version

   應正常顯示版本資訊。

原理說明

ld.so.conf 定義動態連結器搜尋共用函式庫（.so 檔）的目錄。ldconfig 會掃描這些目錄，建立 /etc/ld.so.cache 快取檔供執行階段快速查找。

相關問題

• Wireshark 類似錯誤：缺少 portaudio 函式庫，透過套件管理器安裝對應 -libs 套件
• BoCHS 缺少 libSM.so.6：安裝 libsm6 或對應開發套件

最佳實務

• 優先使用系統套件管理器安裝（apt install imagemagick、yum install ImageMagick），自動處理依賴
• 手動編譯安裝時，./configure --prefix=/usr/local 並確保 /usr/local/lib 在 ld.so.conf 中
• Docker 環境下在 Dockerfile 中執行 ldconfig