JDK 全版本类库详解：Oracle 官方 Java SE API 中文指南 + 示例代码

玩 Java 的都知道，JDK 类库就是咱们吃饭的家伙。不管你是刚入门的新手，还是工作好几年的老鸟，每天写代码都离不开它。从最基础的 String、ArrayList，到处理并发的 ThreadPoolExecutor，再到新出的虚拟线程，这些类库就像乐高积木，你得知道每块积木能干嘛、怎么拼，才能搭出好东西。

但说真的，很多人用了几年 Java，对类库的了解还停留在 “能用就行” 的阶段。遇到问题先百度，复制粘贴改改能用就完事。这可不行！只有吃透 JDK 类库，你才能真正理解 Java 的设计思想，写出高效又安全的代码。比如 ArrayList 和 LinkedList，表面上都是列表，可底层实现差远了 —— 一个查得快，一个插得快。要是用反了场景，数据量大的时候能卡到你怀疑人生。

很多人学类库喜欢找第三方教程，不是说那些不好，但论权威，肯定比不上 Oracle 官方的 API 指南。尤其是现在它出了中文版本，对咱们母语是中文的开发者来说，简直是福音。

你可能会问，英文原版不也能看懂吗？话是这么说，但专业术语翻成中文，理解起来会快很多。比如 “泛型擦除”，直接看英文 “Type Erasure”，新手可能得反应半天。而且官方指南里的例子，都是针对每个方法最典型的用法，不会像有些博客那样掺私货。

不过有个小提醒：中文指南的更新可能会比英文原版慢一点。比如 JDK 21 刚出的新特性，中文指南可能要等一两个月才会同步。所以如果你要追最新版本，建议英文原版和中文指南结合着看。

很多新手拿到 API 文档就懵了，不知道从哪看起。其实有个简单的方法：先看类的 “类注释”，再看核心方法，最后看注意事项。

比如你想了解 HashMap，打开文档先看类上面的说明 —— 它会告诉你这是个基于哈希表的 Map 实现，允许 null 键和 null 值，不是线程安全的。这些信息能帮你快速判断这个类适不适合你的场景。然后看 put、get 这些核心方法，注意看参数和返回值的说明，特别是 “抛出异常” 部分 —— 比如当你用 null 作为键，有些 Map 会抛 NullPointerException，这点不注意很容易踩坑。

还有个小技巧：善用文档里的 “直接已知子类” 和 “相关接口”。比如看 ArrayList 的时候，发现它实现了 List 接口，那你可以顺带去看看 List 里定义的方法，这样能帮你建立整个集合框架的知识体系。

JDK 8 绝对是个里程碑，引入的 Lambda 表达式和 Stream API，直接让集合操作的代码量少了一半。就拿遍历集合来说，以前得写个 for 循环，现在一行 stream ().forEach () 就搞定。但要注意，Stream 的中间操作是惰性的，不调用终止操作（比如 collect、count）的话，中间操作根本不会执行 —— 这坑我当年踩过，调试了半天才发现问题。

JDK 11 加入的 HttpClient，终于把以前的 HttpURLConnection 给替换掉了。这玩意儿是真好用，支持同步也支持异步，还能直接处理 JSON。你试试用它发个 POST 请求，代码比用第三方的 OkHttp 还简洁。对了，它默认支持 HTTPS，不用再像以前那样配置证书了，省了不少事。

到了 JDK 21，虚拟线程（Virtual Thread）绝对是重头戏。以前创建线程成本高，得用线程池控制数量。现在虚拟线程轻量多了，随便创建几千几万个都没问题。不过要注意，虚拟线程适合 IO 密集型任务，要是你用来跑计算密集型任务，性能提升可能不明显，甚至还不如普通线程。

官方指南里的示例代码，都是经过验证的，拿来就能用。但别满足于 “抄作业”，得琢磨它为什么这么写。

比如 String 类的 substring 方法，JDK 8 和 JDK 9 之后的实现不一样。JDK 8 里它会共享原字符串的字符数组，要是原字符串很大，截取一小段后原字符串还被引用，就会造成内存泄漏。JDK 9 之后改成了复制新的字符数组，虽然性能上多了点开销，但更安全。所以看示例的时候，最好注意一下代码注释里有没有提到 “版本差异”。

还有集合框架里的 of () 方法，比如 List.of ()、Map.of ()，这是 JDK 9 新增的，用来创建不可变集合。别小看这个，很多时候我们不希望集合被修改，用它就很方便。但要记住，往这种不可变集合里 add 元素，会直接抛 UnsupportedOperationException，别到时候一脸懵。

先说 SimpleDateFormat，这玩意儿不是线程安全的！以前在项目里，有人图省事把它定义成静态变量，结果多线程环境下格式化出来的日期乱七八糟。后来换成 JDK 8 的 DateTimeFormatter 就没事了，它是线程安全的，推荐大家都用这个。

再说说 Vector 和 Hashtable，这俩是老古董了，虽然线程安全，但性能太差。现在都用 ConcurrentHashMap 和 CopyOnWriteArrayList 替代。尤其是 ConcurrentHashMap，JDK 8 之后用了 CAS+synchronized 的实现，并发性能比以前好太多。

还有 AutoCloseable 接口，像 InputStream、OutputStream 这些实现了它的类，最好用 try-with-resources 语法来写。这样不管代码有没有抛出异常，资源都会自动关闭，比手动写 finally 靠谱多了。我见过太多因为忘记关闭流导致的文件被占用问题，用 try-with-resources 能避免 90% 的资源泄漏。

很多人觉得类库太多，学不过来。其实不用全学，先把核心的几个包吃透就行：java.lang（String、Integer 这些基础类）、java.util（集合框架、日期时间）、java.io 和 java.nio（IO 操作）、java.util.concurrent（并发相关）。这几个包占了日常开发的 80% 以上。

我的方法是 “用中学”：比如要做个文件导入功能，就专门去研究 java.nio.file 里的 Path、Files 类；要处理并发任务，就把 ThreadPoolExecutor 的核心参数（核心线程数、最大线程数、拒绝策略）搞明白。遇到问题先自己查文档试，解决完之后记个笔记，把用法和注意事项写下来。

还有个好习惯：定期看 JDK 的更新日志。Oracle 官网会列出每个版本新增和废弃的 API，比如 JDK 17 里标记为废弃的 SecurityManager，你就别在新项目里用了，省得以后升级 JDK 的时候还要改代码。

JDK 类库就像一本字典，你不用把每个字都背下来，但要知道怎么快速查到它，理解它的用法。别觉得基础的东西没意思，真正能拉开差距的，就是这些基本功。我见过不少能写复杂框架的开发者，却在 ArrayList 和 LinkedList 的选择上犯低级错误。

记住，官方文档永远是最好的老师。遇到问题先翻 Oracle 的 Java SE API 指南，比瞎搜博客靠谱多了。如果英文不太好，中文指南足够你用到中高级水平。等你对类库熟悉到一定程度，就会发现写代码越来越顺，调试也越来越快 —— 这就是内功的力量。

【该文章由dudu123.com嘟嘟 ai 导航整理，嘟嘟 AI 导航汇集全网优质网址资源和最新优质 AI 工具】