Java API文档是工具书而非小说，应先通过左侧包导航（如java.util、java.time）定位功能归属，再进入类查看方法签名、@param/@return/@throws说明及官方示例，结合IDE快捷键（如Ctrl+Q）实现查得快、看得懂、用得准。
直接打开文档看类名、方法签名和示例，比通读全文更有效。API 文档不是小说，是工具书；源码不是教材，是运行时逻辑的快照。关键在用得准、查得快、看得懂。
Java API 文档：先结构，再搜索，最后细读
左侧导航栏是包（package）列表，比如 java.util、java.time，点开就能看到该包下所有类和接口。不要跳过这一步——熟悉包结构能帮你预判功能归属，比如日期操作一定在 java.time，集合操作一定在 java.util。
进入某个类（如 ArrayList）后，右侧会列出所有方法。优先扫三类内容：
-
方法签名：看清返回类型、参数类型和名称（如
public E get(int index)） -
@param / @return / @throws：这是实际编码时最常踩坑的地方，比如
get()明确要求index ≥ 0 && index < size()，否则抛IndexOutOfBoundsException - “Example”段落：官方给的代码片段通常可直接复制修改，比自己从零写更可靠
本地文档 + IDE 集成：把查阅变成编码的一部分
下载 Oracle 或 OpenJDK 官方 Javadoc ZIP 包，解压后记下路径（如 C:\jdk17\docs\api）。在 IntelliJ IDEA 中：File → Project Structure → SDKs → 选中 JDK → 右侧“Documentation path”点击 + 号，添加该路径。之后光标停在任意类或方法上，按 Ctrl+Q（Windows/Linux）或 F1（macOS），就能弹出带格式、可跳转的文档摘要。
立即学习“Java免费学习笔记（深入）”；
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
Eclipse 用户可在 Preferences → Java → Build Path → User Entries → Add Library → JRE System Library → Edit → Attach Source and Javadoc 中配置。配置完成后，悬停提示自动带链接，点一下直达完整页面。
开源源码阅读：从一个方法切入，顺藤摸瓜
别一上来就 clone 整个 Spring 或 Netty 仓库。明确一个具体问题，例如：“Spring Boot 是怎么自动装配 DataSource 的？”然后：
- 在 IDE 中用 Ctrl+Shift+N 搜索关键词
DataSourceAutoConfiguration - 打开该类，找到
@Bean方法，比如dataSource() - 按 Ctrl+B 跳转到
HikariDataSource构造过程，再跳到其父类、配置加载逻辑 - 配合 Debug：设断点，启动应用，观察实例化顺序和参数来源
这个过程不是读完全部代码，而是构建一条“调用链认知”，下次遇到类似机制（如自动配置、AOP织入），路径就清晰了。
避开常见误区：少做、多试、常验证
很多人卡在“看不懂注释”或“术语太多”，其实不必强记术语。遇到陌生词（如 transient、serialVersionUID），直接搜 Java 官方教程对应章节，5 分钟解决一个点。更高效的做法是：
- 写一行代码，调一个方法，立刻看它返回什么、抛什么异常
- 改一个参数值，观察行为变化（比如
String.substring(5)越界时的报错信息比文档更直白） - 把文档里的示例粘贴进测试类，加断点单步执行，看变量怎么变
文档和源码的价值不在“看过”，而在“用过”。每次成功调用一个新 API，或搞懂一段关键源码，都意味着你对 Java 运行机制的理解又深了一层。
