一种可能的(也是常见的)用途是，当您有一些不是线程安全的对象，但您希望避免同步访问该对象(我正在看您，SimpleDateFormat)。相反，给每个线程它自己的对象实例。

例如:

public class Foo
{
    // SimpleDateFormat is not thread-safe, so give one to each thread
    private static final ThreadLocal<SimpleDateFormat> formatter = new ThreadLocal<SimpleDateFormat>(){
        @Override
        protected SimpleDateFormat initialValue()
        {
            return new SimpleDateFormat("yyyyMMdd HHmm");
        }
    };

    public String formatIt(Date date)
    {
        return formatter.get().format(date);
    }
}

文档。

文档说得很好:“每个访问[线程局部变量]的线程(通过它的get或set方法)都有它自己的、独立初始化的变量副本”。

当每个线程必须有自己的某个副本时，可以使用一个。默认情况下，数据在线程之间共享。

当您希望某些状态不应该在不同线程之间共享，但每个线程在其整个生命周期内都可以访问时，ThreadLocal非常有用。

As an example, imagine a web application, where each request is served by a different thread. Imagine that for each request you need a piece of data multiple times, which is quite expensive to compute. However, that data might have changed for each incoming request, which means that you can't use a plain cache. A simple, quick solution to this problem would be to have a ThreadLocal variable holding access to this data, so that you have to calculate it only once for each request. Of course, this problem can also be solved without the use of ThreadLocal, but I devised it for illustration purposes.

也就是说，请记住ThreadLocals本质上是一种全局状态的形式。因此，它有许多其他含义，只有在考虑了所有其他可能的解决方案后才应该使用。

在Java中，如果您有一个每个线程都可以变化的数据，那么您可以选择将该数据传递给每个需要(或可能需要)它的方法，或者将该数据与线程关联。如果你的所有方法都需要传递一个公共的“上下文”变量，那么到处传递数据可能是可行的。

如果不是这样，您可能不希望用额外的参数来打乱方法签名。在非线程环境中，可以使用Java中等价的全局变量来解决这个问题。在线程词中，与全局变量等价的是线程局部变量。

自Java 8发布以来，有更多的声明性方法来初始化ThreadLocal:

ThreadLocal<String> local = ThreadLocal.withInitial(() -> "init value");

在Java 8发布之前，你必须做以下事情:

ThreadLocal<String> local = new ThreadLocal<String>(){
    @Override
    protected String initialValue() {
        return "init value";
    }
};

此外，如果用于ThreadLocal的类的实例化方法(构造函数，工厂方法)不接受任何参数，您可以简单地使用方法引用(在Java 8中引入):

class NotThreadSafe {
    // no parameters
    public NotThreadSafe(){}
}
    
ThreadLocal<NotThreadSafe> container = ThreadLocal.withInitial(NotThreadSafe::new);

注意: 计算是惰性的，因为你传递的java.util.function.Supplier lambda只在调用ThreadLocal#get但value之前没有计算时才会计算。

您必须非常小心地使用ThreadLocal模式。有一些主要的缺点，如Phil所提到的，但其中一个没有提到的是，要确保设置ThreadLocal上下文的代码不是“可重入的”。

当设置信息的代码第二次或第三次运行时，可能会发生糟糕的事情，因为线程上的信息可能会在您没有预料到的时候开始发生变化。因此，在再次设置ThreadLocal信息之前，请注意确保没有设置它。