应优先使用APT安装openjdk-11-jdk并配置系统级JAVA_HOME：执行sudo apt update && sudo apt install openjdk-11-jdk，用readlink -f $(which java) | sed 's|/jre/bin/java||'获取路径，写入/etc/environment后重新登录生效。

如果您在统信UOS系统中准备运行Java程序或部署Java项目，但终端执行java -version提示命令未找到或版本异常，则说明Java环境尚未安装或环境变量未正确配置。以下是多种兼容UOS不同场景的JDK安装与环境变量配置方法：

一、通过应用商店图形化安装

该方式无需使用终端命令，全程图形界面操作，适用于对Linux命令不熟悉、仅需基础Java运行环境的用户。安装后JDK路径由应用商店沙箱管理，需手动提取真实路径并配置环境变量。

1、点击“开始菜单” → “应用商店”，在搜索框输入“Java”或“JDK”。

2、从搜索结果中选择官方认证的“OpenJDK 11”或“OpenJDK 17”应用，点击“安装”按钮。

3、安装完成后，打开终端，执行：dpkg -l | grep openjdk，确认已安装包名（如openjdk-11-jdk:amd64）。

4、根据包名查询Java可执行文件实际路径：dpkg -L openjdk-11-jdk | grep bin/java，输出类似/opt/apps/org.bisheng.openjdk11/files/bin/java。

5、提取JAVA_HOME路径（即去除/bin/java后的上级目录），例如/opt/apps/org.bisheng.openjdk11/files，然后编辑当前用户环境文件：nano ~/.bashrc。

6、在文件末尾添加以下三行（路径请严格按上一步实际输出替换）：
export JAVA_HOME=/opt/apps/org.bisheng.openjdk11/files
export PATH=$JAVA_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/jre/lib

7、执行source ~/.bashrc使配置立即生效，并运行java -version验证。

二、使用APT包管理器安装

该方法依赖UOS官方软件源，安装过程自动处理依赖关系，路径规范统一（默认位于/usr/lib/jvm/），适用于开发、测试及生产环境快速部署，且便于后续系统级统一管理。

1、打开终端，更新软件包索引：sudo apt update。

2、安装OpenJDK 11开发包：sudo apt install openjdk-11-jdk。

3、验证基础命令：java -version与javac -version应均返回版本信息。

4、查询JDK真实安装路径：readlink -f $(which java) | sed 's|/jre/bin/java||'，典型输出为/usr/lib/jvm/java-11-openjdk-amd64。

5、将JAVA_HOME写入系统级环境文件：sudo nano /etc/environment。

6、在文件末尾新增一行（路径须与第4步输出完全一致）：JAVA_HOME="<strong><font color="green">/usr/lib/jvm/java-11-openjdk-amd64</font></strong>"。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

7、保存退出后，重新登录图形界面或重启用户会话，确保IDE等GUI程序可读取该变量。

三、手动解压安装Adoptium JDK或Oracle JDK

当需使用特定厂商JDK（如Oracle JDK）、特定小版本（如JDK 8u341）或国产CPU平台（鲲鹏/飞腾）专用构建时，应采用tar.gz二进制包方式安装。该方式独立于系统包管理器，便于多版本共存与路径自定义。

1、访问Adoptium官网（https://www.php.cn/link/e387385ebe0dbeefed3e8e9f3968aaba）下载Linux x64或AArch64的tar.gz格式JDK（如jdk-17.0.1+12-hotspot）。

2、将下载文件移动至/opt目录：sudo mv jdk-17.0.1+12-hotspot.tar.gz /opt/。

3、解压到/opt/jdk-17：sudo tar -xzf /opt/jdk-17.0.1+12-hotspot.tar.gz -C /opt/。

4、设置目录权限：sudo chown -R root:root /opt/jdk-17。

5、编辑全局环境配置文件：sudo nano /etc/environment。

6、在文件末尾添加两行（以Adoptium JDK路径为例）：
JAVA_HOME="/opt/jdk-17"
PATH="/opt/jdk-17/bin:$PATH"

7、保存退出后，执行source /etc/environment使配置生效，并运行java -version验证。

四、配置开发者模式并启用root权限

统信UOS默认禁用root直接登录，且对系统级操作实施严格权限控制。必须先获得合法root权限，才能执行JDK安装与全局环境配置。未完成该步骤可能导致后续命令被拒绝或配置不生效。

1、点击左下角“启动器”，打开“控制中心”。

2、在左侧菜单选择“通用”，找到“开发者模式”选项。

3、点击“进入开发者模式”，输入当前用户密码完成验证。

4、系统提示配置完成后，重启计算机。

5、重启后打开终端，执行sudo -i切换至root用户（避免重复输入密码）。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南