Linux 安裝 PyCharm 提示 "No JDK found" 完整解決方案

PyCharm 為 Java 應用 (基於 IntelliJ 平台)，啟動時需偵測有效的 JDK 環境。Linux 下常見錯誤：

Error: cannot start PyCharm
No JDK found to run PyCharm. Please validate either PYCHARM_JDK, JDK_HOME or JAVA_HOME environment variable points to valid JDK installation.

本文提供標準修復流程、環境變數永久配置與多 JDK 管理建議。

快速修復 (臨時生效)

# 1. 確認 JDK 安裝路徑 (以 OpenJDK 17 為例)
ls /usr/lib/jvm/
# 輸出範例: java-17-openjdk-amd64  java-11-openjdk-amd64

# 2. 設定環境變數並啟動
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH
# 進入 PyCharm bin 目錄執行
./pycharm.sh

永久配置 (推薦)

方法一：系統級配置 (所有用戶生效)

sudo vim /etc/profile.d/pycharm-jdk.sh

寫入：

export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

儲存後：source /etc/profile.d/pycharm-jdk.sh 或重新登入。

方法二：用戶級配置 (僅當前用戶)

vim ~/.bashrc
# 或 ~/.profile (登入 Shell 讀取)
# 末尾加入：
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

source ~/.bashrc 生效。

方法三：PyCharm 專屬配置 (不影響系統)

編輯 PyCharm 安裝目錄下的 bin/pycharm64.vmoptions (或 pycharm.vmoptions)：

-vm
/usr/lib/jvm/java-17-openjdk-amd64/bin/java

此為 JVM 啟動參數，優先級最高，專指定 PyCharm 使用的 Java 執行檔。

安裝 JDK (若系統未裝)

# Ubuntu/Debian
sudo apt update && sudo apt install openjdk-17-jdk

# CentOS/RHEL/Fedora
sudo dnf install java-17-openjdk-devel

# Arch/Manjaro
sudo pacman -S jdk17-openjdk

多 JDK 環境管理

系統共存多個 JDK 時，使用 update-alternatives 切換預設：

# 註冊
sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-17-openjdk-amd64/bin/java 1700
sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-17-openjdk-amd64/bin/javac 1700

# 互動式切換
sudo update-alternatives --config java
sudo update-alternatives --config javac

或使用 SDKMAN! 管理多版本 JDK/IDE (強烈推薦開發者使用)。

驗證

java -version
# 輸出應包含 "OpenJDK Runtime Environment" 或 "Java(TM) SE Runtime Environment"
# 且版本符合預期 (如 17.0.x)

# PyCharm 內部驗證
Help → About → Build # → JDK: 17.x.x (應顯示正確路徑)

常見誤區

核心心法：「PyCharm 找 JDK 靠三環境變數 + vmoptions，裝 JDK 要 -jdk 別裝 -jre，路徑指根目錄別指連結」。