总体评价
Debian 对 Java 的文档覆盖度较高，能满足大多数安装、版本切换与日常开发需求：官方与社区提供了安装与配置指南、JDK 文档包、虚拟包与 alternatives 切换机制说明，以及系统级的参考手册。但与上游 OpenJDK 的 API 手册或语言规范相比，Debian 仓库更侧重“如何在 Debian 上安装与管理 Java”，API 级细节通常仍需查阅上游文档或安装相应的 -doc 包。总体可满足运维与开发，但不等同于完整的语言/平台手册集。
主要文档来源与覆盖点
- 安装与环境配置：提供在 Debian 上安装 OpenJDK 或 Oracle JDK、设置 JAVA_HOME / JRE_HOME / CLASSPATH / PATH、验证版本等步骤的指南，适合新手快速上手与服务器部署。
- JDK 文档包：可通过 APT 安装如 openjdk--doc 的文档包，文档通常位于 /usr/share/doc/openjdk-/，便于离线查阅 API 与说明。
- 软件包自带文档：多数 Java 相关库/工具会将文档随包提供，位于 /usr/share/doc//，包括示例、README、变更日志等。
- 虚拟包与版本管理：Debian 使用 javaX-runtime / javaX-runtime-headless 等虚拟包描述运行时能力，多个 JDK/JRE 并存时用 update-alternatives / update-java-alternatives 统一管理，并有关于默认版本随发行版与架构差异的说明。
- 参考手册与社区资料：Debian 参考手册与社区教程可补充系统层面的操作与故障排查，但部分内容可能随版本更新而变动，需以最新文档为准。
常见缺口与补齐方式
- API 与语言规范：Debian 仓库侧重“安装与管理”，若需要 Java SE API 详细文档、语言规范或特定版本的勘误，建议直接查阅 OpenJDK 官方文档 或安装相应的 -doc 包获取离线 HTML/PDF。
- 第三方库文档：多数第三方库的文档随包提供（见 /usr/share/doc/），若需示例、最佳实践或在线 API 索引，通常还需访问项目主页或社区站点。
- 版本差异与变更：不同 Debian 版本/架构 的默认 Java 可能不同，且文档会随时间更新；遇到不一致时，优先查阅对应版本的官方文档与包说明。
快速上手命令示例
- 安装默认 JRE/JDK：sudo apt-get install default-jre；sudo apt-get install default-jdk；验证：java -version、javac -version。
- 安装 OpenJDK 文档：sudo apt-get install openjdk-11-doc（版本号按需替换）；文档路径：/usr/share/doc/openjdk-11/。
- 多版本切换：使用 update-alternatives --config java（或 update-java-alternatives -l 查看可用版本），按提示选择系统默认 Java。