Debian Java配置新手必看指南

Debian Java配置新手必看指南

一 安装前准备

• 更新软件包索引，确保系统软件源正常：
  • 执行：sudo apt update
• 建议先升级已安装软件包（可选）：
  • 执行：sudo apt upgrade -y
• 说明：Debian 官方仓库提供 OpenJDK，使用包管理器安装可自动处理依赖与更新，是最简单且推荐的方式。

二 安装 OpenJDK

• 安装默认 JDK（适合大多数场景）：
  • 执行：sudo apt install default-jdk
• 安装指定版本（常见为 OpenJDK 11 或 OpenJDK 8）：
  • 执行：sudo apt install openjdk-11-jdk 或 sudo apt install openjdk-8-jdk
• 验证安装是否成功：
  • 查看运行时版本：java -version
  • 查看编译器版本：javac -version
• 提示：仅运行程序可安装 default-jre；开发需安装 default-jdk 或对应版本的 -jdk。

三 配置 JAVA_HOME 与 PATH

• 查找已安装 JDK 的实际路径（用于设置 JAVA_HOME）：
  • 执行：sudo update-alternatives --config java（从列表中选择或查看路径，通常为 /usr/lib/jvm/java-11-openjdk-amd64 或 /usr/lib/jvm/java-8-openjdk-amd64）
• 方案 A（用户级生效，推荐）：编辑 ~/.bashrc
  • 添加：

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

  • 使配置生效：source ~/.bashrc
• 方案 B（系统级生效）：编辑 /etc/environment
  • 添加（或确保存在）：JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"
  • 使配置生效：source /etc/environment
• 验证变量是否生效：
  • 执行：echo $JAVA_HOME（应返回 JDK 路径）
  • 执行：which java 与 readlink -f $(which java)（确认指向期望的 JDK 目录）
• 注意：PATH 中建议将 $JAVA_HOME/bin 放在前面，以避免调用到旧版本。

四 多版本管理与切换

• 使用 update-alternatives 注册与切换版本：
  • 注册 Java 可执行文件：

    sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-11-openjdk-amd64/bin/java 300
    sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-8-openjdk-amd64/bin/java 200
    

  • 注册编译器（可选，便于构建工具使用正确 javac）：

    sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-11-openjdk-amd64/bin/javac 300
    sudo update-alternatives --install /usr/bin/javac javac /usr/lib/jvm/java-8-openjdk-amd64/bin/javac 200
    

  • 交互式选择默认版本：sudo update-alternatives --config java（同理可对 javac 执行）
• 验证当前默认版本：java -version 与 javac -version。

五 快速验证与常见问题

• 快速验证
  • 编写测试程序 HelloWorld.java：

    public class HelloWorld {
        public static void main(String[] args) {
            System.out.println("Hello, World!");
        }
    }
    

  • 编译与运行：

    javac HelloWorld.java
    java HelloWorld
    

  • 预期输出：Hello, World!
• 常见问题与处理
  • 命令未找到或版本不对：检查 JAVA_HOME 是否指向正确 JDK，确认 PATH 包含 $JAVA_HOME/bin，并使用 which java 与 readlink -f 定位实际可执行文件。
  • 环境变量不生效：确认修改的是当前使用的 Shell 配置文件（如 ~/.bashrc、~/.zshrc 或 /etc/environment），并执行 source 使其生效；必要时重新登录终端或重启会话。
  • 多版本冲突：使用 update-alternatives --config java 统一默认版本，确保 java 与 javac 版本一致。