Eclipse 中 UnsatisfiedLinkError 解決方案大全：SWT 原生庫路徑配置兩大法

錯誤現象

Exception in thread "main" java.lang.UnsatisfiedLinkError: no swt-win32-3063 in java.library.path
// 或 Mac: no swt-pi-carbon-3063, Linux: no swt-pi-gtk-3063

原因：JVM 找不到 SWT 所需的原生庫（.dll/.so/.jnilib），版本號對應 Eclipse 版本（3063 = 3.0.1）。

方法一：複製 DLL 到系統庫路徑（Windows 推薦）

1. 開啟命令提示字元，執行 echo %PATH% 確認系統路徑包含 C:\WINNT (或 C:\Windows\System32)。
2. 複製 SWT 原生庫至該目錄：

   copy "C:\Program Files\eclipse\plugins\org.eclipse.swt.win32_3.0.1\os\win32\x86\*" C:\WINNT

3. 重新運行 SWT 程式。

每次升級 Eclipse 後需重複此步驟，因版本號變更導致庫文件名改變。

方法二：啟動參數指定 java.library.path（通用、不污染系統目錄）

1. Eclipse 選單 Run > Run Configurations... (或 Run > Run...)。
2. 選擇對應 Java Application，切換 Arguments 標籤。
3. 在 VM Arguments 添加（根據平台與 Eclipse 版本調整路徑）：
   • Windows (3.0.1): -Djava.library.path=${eclipse_home}/plugins/org.eclipse.swt.win32_3.0.1/os/win32/x86
   • Mac OS X Carbon: -Djava.library.path=${eclipse_home}/plugins/org.eclipse.swt.carbon_3.0.1/os/macosx/ppc
   • Linux GTK2: -Djava.library.path=${eclipse_home}/plugins/org.eclipse.swt.gtk_3.0.1/os/linux/x86
4. 應用並運行。

原理對比

進階：專案級配置

在專案 .classpath 或 Maven/Gradle 建構腳本中配置 -Djava.library.path，實現「專案自帶原生庫路徑」，完全消除環境依賴。

總結

遇到 UnsatisfiedLinkError 先確認：Eclipse 版本、SWT 插件版本、原生庫實際路徑 三者一致。推薦使用方法二（VM 參數），乾淨、可攜帶、易於團隊協作。