Linux 安裝 JITWatch 完整教學：Java JIT 編譯分析工具部署指南

JITWatch 是一款開源的 Java JIT（Just-In-Time）編譯分析視覺化工具，能幫助開發者理解 JVM 熱點代碼編譯決策、內聯情況、反組譯代碼等。本文詳細記錄在 Linux 系統中從原始碼構建安裝 JITWatch，以及安裝 hsdis 反組譯插件的完整步驟。

一、前置需求

• Git：用於克隆原始碼
• Maven：用於構建專案（需 3.3+ 版本）
• JDK 8+：建置與執行環境
• 網路連線（下載依賴）

二、安裝並執行 JITWatch

1. 取得原始碼

# 方式一：Git 克隆（推薦）
git clone https://github.com/AdoptOpenJDK/jitwatch.git
cd jitwatch

# 方式二：下載 ZIP 壓縮包並解壓
# https://github.com/AdoptOpenJDK/jitwatch/archive/refs/heads/master.zip

2. 構建安裝

mvn clean install -DskipTests=true

說明：

• clean：清理先前建置產物
• install：編譯、測試、打包並安裝至本地 Maven 倉庫
• -DskipTests=true：跳過單元測試加速建置

3. 啟動 JITWatch 圖形介面

./launchUI.sh

啟動後會開啟 JavaFX 視窗，可載入 JIT 日誌（-XX:+PrintCompilation -XX:+LogCompilation）進行分析。

三、安裝 hsdis 反組譯插件（查看組合語言輸出）

JITWatch 預設僅顯示位元碼，若需查看 JIT 編譯後的原生機器碼（x86-64、ARM 等），必須安裝 hsdis。

1. 取得 hsdis

• 官方來源：https://github.com/chriswhocodes/hsdis
• 或使用預編譯版本（需匹配 JDK 版本與架構）

2. 安裝步驟

# 1. 重新命名下載的檔案
mv hsdis-<版本>-<架構>.so hsdis-amd64.so

# 2. 放入 JDK 目錄
# 假設 JAVA_HOME=/usr/lib/jvm/java-11-openjdk
cp hsdis-amd64.so $JAVA_HOME/lib/amd64/server/

# 3. 驗證
ls -la $JAVA_HOME/lib/amd64/server/hsdis-amd64.so

注意事項

• 檔名必須為 hsdis-amd64.so（64 位元 Linux）
• 目錄路徑視 JDK 發布版而異，常見於 jre/lib/amd64/server/ 或 lib/server/
• JDK 9+ 模組化後，可能需額外配置 --add-modules jdk.incubator.foreign 等

四、JITWatch 核心功能速覽

五、常見問題排查

• Maven 建置失敗：檢查 JDK 版本、網路代理設定、settings.xml 鏡像源
• launchUI.sh 無法啟動：確認安裝 JavaFX（JDK 11+ 需額外安裝 openjfx）
• hsdis 不生效：檢查檔名、路徑、架構匹配度，查看 JVM 啟動日誌是否載入

完成上述步驟後，您將擁有一套完整的 Java JIT 編譯分析環境，能深入洞察 JVM 執行時編譯決策，為效能調優提供科學依據。