ThreadLocal 是为每个线程提供独立副本的变量工具，其值存储在各线程的 threadLocals（ThreadLocalMap）中，key 为弱引用，value 为强引用。
ThreadLocal 不是“线程本地的变量”，而是“为每个线程提供独立副本的变量工具”。它不把变量绑在 ThreadLocal 实例上，而是把变量副本存在每个 Thread 对象内部的 threadLocals（一个 ThreadLocalMap） 里。
每个线程都有自己的“抽屉”
Java 中每个 Thread 实例都持有一个私有字段：
ThreadLocal.ThreadLocalMap threadLocals = null;
这个 map 就是线程专属的“储物抽屉”。当你调用 threadLocal.set("abc") 时，实际发生的是：
立即学习“Java免费学习笔记（深入）”；
- 拿到当前线程对象
Thread.currentThread() - 获取它的
threadLocals（若为 null 则新建一个） - 以当前这个
threadLocal实例为 key，以"abc"为 value，存进该 map
所以，不同线程调用同一个 threadLocal.get()，查的是各自线程的 map，自然互不干扰。
key 是弱引用，value 不是
ThreadLocalMap 的 Entry 定义是：
static class Entry extends WeakReference
也就是说：key（ThreadLocal 实例）是弱引用，value（你存的数据）是强引用。
这带来一个关键风险：如果 ThreadLocal 实例被回收（比如 static 引用被置 null），但线程还在运行（如线程池中的线程），那么 map 中的 key 变成 null，但 value 还留着——Entry 成为“僵尸条目”，造成内存泄漏。
因此，务必在使用完后调用 threadLocal.remove()，尤其在线程复用场景（如 Web 容器、线程池）中。
set/get/remove 都在操作当前线程的 map
所有核心方法逻辑统一：
-
set(T value)：找当前线程 → 初始化或获取 threadLocals → 插入/覆盖 (this, value) -
get()：找当前线程 → 获取 threadLocals → 查 this 对应的 value；若没值，触发initialValue()（只执行一次）并写入 -
remove()：从 threadLocals 中删除以 this 为 key 的 Entry，清掉 value 引用
注意：ThreadLocal.withInitial(() -> ...) 是 Java 8 推荐写法，本质就是帮你封装了 initialValue()，更简洁安全。
典型用途和避坑点
常见用法包括：
- 避免 SimpleDateFormat、Random 等非线程安全对象的同步开销
- 透传请求上下文（用户ID、traceId、事务状态），替代层层传参
- Spring 事务管理中绑定 Connection 到当前线程
必须警惕的坑：
- 在线程池中忘了
remove()→ 上一个请求的用户信息/traceId 泄露给下一个请求（线程污染） - 用匿名内部类重写
initialValue()却没声明为 static → 持有外部类引用，放大内存泄漏 - 把大对象（如缓存 Map、IO 缓冲区）长期放在 ThreadLocal 里，又不清理 → OOM 风险
基本上就这些。原理不复杂，但容易忽略细节。
