Swift结构化并发中是否存在Thread.threadDictionary的等效实现？

Swift 结构化并发中对应 Thread.threadDictionary 的等效功能是 任务本地值（Task Local Value），完全可以满足无需显式传参、在同任务树的多个异步方法间共享状态的需求。

核心使用方式 #

1. 声明共享状态 #

使用 @TaskLocal 属性包装器声明你的共享状态，通常定义为静态属性即可：

// 你的框架内部的状态定义
public enum MyFrameworkSharedState {
    @TaskLocal public static var currentContext: MyContext?
}

2. 绑定状态 #

通过 withValue 方法绑定状态，在闭包内发起的所有异步调用、子任务都会自动继承该状态：

// 业务侧使用时绑定状态
try await MyFrameworkSharedState.$currentContext.withValue(MyContext(enableLog: true)) {
    // 以下异步方法无需显式传入context即可读取到绑定值
    try await yourFrameworkAsyncMethod1()
    try await yourFrameworkAsyncMethod2()
    
    // 子任务同样会继承绑定的状态
    let subResult = try await Task {
        try await yourFrameworkAsyncSubMethod()
    }.value
}

3. 异步方法内读取状态 #

在框架的异步方法内部直接读取声明的TaskLocal属性即可，不需要额外传参：

func yourFrameworkAsyncMethod1() async throws {
    guard let context = MyFrameworkSharedState.currentContext else {
        throw FrameworkError.missingContext
    }
    // 基于context执行业务逻辑
}

关键特性与适配建议 #

• 任务本地值跟随任务生命周期走，和线程调度完全无关：哪怕任务执行过程中被切换到不同线程，也能正确读取到绑定的状态，完美适配结构化并发的调度模型，不会出现线程切换导致状态丢失的问题。
• 状态继承单向隔离：父任务绑定的状态会传递给所有子任务，子任务如果重新绑定同个TaskLocal的值，只会影响自身和它的子任务，不会修改父任务的状态，符合结构化并发的安全隔离规则。
• 如果你需要兼容原有基于Thread.threadDictionary的同步接口，可以做一层统一封装：在读取状态时先判断当前上下文，异步上下文读TaskLocal值，同步上下文读Thread.threadDictionary即可，原有业务侧代码不需要做修改。

内容的提问来源于stack exchange，提问作者Terrence