ThreadLocal 是 Java 中一个非常重要的类，它位于 java.lang 包中，自 JDK 1.2 版本起就已提供。它的核心作用是为每个线程提供一个变量的独立副本，从而实现线程间的数据隔离。

简单来说，ThreadLocal 让你能够创建一个变量，虽然代码中看起来是同一个变量，但每个线程都有自己专属的“私人拷贝”，互不干扰。

🧩 核心原理：以空间换时间

ThreadLocal 的设计思想可以概括为“以空间换时间”。

*   核心机制：每个线程（Thread）的内部都持有一个 ThreadLocalMap 对象。这个 Map 以 ThreadLocal 实例本身作为键（Key），以线程专属的变量副本作为值（Value）。
*   数据隔离：当不同线程调用同一个 ThreadLocal 变量的 get() 或 set() 方法时，它们操作的实际上是各自线程内部 Map 中的数据，因此天然就是线程安全的，无需加锁。
*   对比：这与 synchronized 关键字的思路正好相反，synchronized 是“以时间换空间”，通过加锁串行化来保证安全，但会带来性能损耗。

🛠️ 常用方法

ThreadLocal 类提供了几个核心方法来操作线程本地变量：
方法   描述
void set(T value)   为当前线程设置一个变量副本。
T get()   获取当前线程对应的变量副本。
void remove()   移除当前线程的变量副本，非常重要。
protected T initialValue()   受保护的方法，用于提供变量的初始值。通常通过匿名内部类的方式重写。

🌟 典型应用场景

ThreadLocal 非常适合用于需要跨多个方法或组件传递线程专属上下文信息的场景，例如：

*   数据库连接管理：在同一个事务中，确保所有数据库操作使用同一个连接。
*   用户会话信息：在 Web 应用中，存储当前用户的登录信息，方便在业务逻辑的任何地方获取。
*   格式化工具：如 SimpleDateFormat，它是线程不安全的，可以使用 ThreadLocal 为每个线程提供一个独立实例。

⚠️ 关键注意事项

使用 ThreadLocal 时，有两个关键点需要特别注意：

1.  务必调用 remove()
    这是使用 ThreadLocal 最重要的实践。ThreadLocalMap 中的键（Key）是对 ThreadLocal 实例的弱引用，但值（Value）是强引用。如果线程是长期运行的（例如线程池中的线程），并且没有手动调用 remove()，那么这些值将永远不会被垃圾回收，从而导致内存泄漏。因此，应该在使用完 ThreadLocal 后，立即调用 remove() 方法清除数据。

2.  父子线程数据传递
    普通的 ThreadLocal 变量在父线程中设置的值，无法在子线程中获取到。如果需要实现这种“继承”关系，Java 提供了 InheritableThreadLocal 类。它扩展了 ThreadLocal，可以在创建子线程时，将父线程的值自动传递给子线程。

💻 代码示例

下面是一个简单的示例，展示了如何使用 ThreadLocal 为每个线程保存用户信息：

public class UserContext {
    // 定义一个ThreadLocal变量来存储用户名称
    private static ThreadLocal userThreadLocal = new ThreadLocal();

    public static void setCurrentUser(String userName) {
        userThreadLocal.set(userName);
    }

    public static String getCurrentUser() {
        return userThreadLocal.get();
    }

    public static void clear() {
        // 使用完毕后务必清除
        userThreadLocal.remove();
    }
}

// 在多线程环境中使用
public class ThreadLocalDemo {
    public static void main(String[] args) {
        Runnable task = () -> {
            // 为当前线程设置用户
            UserContext.setCurrentUser(Thread.currentThread().getName());
            
            try {
                // 模拟业务处理
                System.out.println("当前线程: " + UserContext.getCurrentUser());
            } finally {
                // 任务结束，清理ThreadLocal
                UserContext.clear();
            }
        };

        // 启动多个线程
        new Thread(task, "用户-A").start();
        new Thread(task, "用户-B").start();
    }
}

在这个例子中，两个线程分别设置了不同的用户名称，但互不影响，各自都能正确获取到自己设置的值。

一个经典用法：

每个用户请求后台都会在独立的线程中处理，当页面做国际化时，会在请求头添加locate信息（如zh-cn），后台可以把locate数据存为ThreadLocal变量，用配置的bizcode拼接这个locate做为键，到redis读取相应语言的数据，每个用户在线程关闭前都可以保持页面的locate不变且相互不冲突。