如何看懂java文档
理解Java文档结构
Java文档（Javadoc）通常以HTML格式呈现，包含类、接口、方法、字段等详细说明。文档顶部会显示包名和类名，左侧导航栏列出所有类、接口和包，方便快速跳转。
关注类或接口的概述
每个类或接口的文档开头会有简要描述，解释其用途和功能。这部分通常包含@author、@version等标签，提供作者和版本信息。仔细阅读概述能快速理解该类的核心作用。
方法签名与参数说明
方法文档会显示方法签名，包括返回类型、方法名和参数列表。每个参数旁会有@param标签说明其用途，返回值旁会有@return标签描述返回值的含义。例如：
public String substring(int beginIndex, int endIndex)@param beginIndex 表示起始索引，@param endIndex 表示结束索引。
异常与使用示例
方法可能抛出的异常会通过@throws或@exception标签列出，并说明触发条件。部分文档会包含@see标签，指向相关类或方法。若文档提供示例代码（@code标签），可帮助理解实际用法。
版本与兼容性信息
通过@since标签可以了解方法或类引入的JDK版本，@deprecated标签标记已过时的功能，并可能推荐替代方案。这对于维护旧代码或升级JDK版本非常重要。
实践与搜索技巧
遇到不熟悉的方法时，可通过IDE（如IntelliJ IDEA）直接查看内联文档。结合官方文档搜索功能（Ctrl+F）快速定位关键词。对于复杂类（如java.util.Collections），优先阅读常用方法的文档，再逐步深入。
