获取当前线程独立标识

✅ 最常用：Environment.CurrentManagedThreadId

using System;

void Foo()
{
    int threadId = Environment.CurrentManagedThreadId;
    Console.WriteLine($"当前线程ID: {threadId}");
}

特点

• ✔ 进程内唯一
• ✔ 线程生命周期内不变
• ✔ 最常用、最推荐
• ❗ 不是操作系统的原生线程 ID

👉 99% 场景用这个就够了

⚠️ 如果你在用 async / await（重点）

async Task FooAsync()
{
    int threadId = Thread.CurrentThread.ManagedThreadId;
    await Task.Delay(1000);
    int threadId2 = Thread.CurrentThread.ManagedThreadId;

    Console.WriteLine($"{threadId} -> {threadId2}");
}

注意

• await 前后线程可能不一样
• ManagedThreadId 会变化
• 因为 async 本质是 任务调度，不是线程绑定

👉 如果你想标识的是**“一次逻辑执行流程”**，而不是线程本身，看下面👇

✅ 逻辑级唯一标识（强烈推荐 async 场景）

AsyncLocal<T>

static AsyncLocal<Guid> _traceId = new();

void Init()
{
    _traceId.Value = Guid.NewGuid();
}

void Foo()
{
    Console.WriteLine($"逻辑ID: {_traceId.Value}");
}

特点

• ✔ 在 async/await 链路中保持一致

• ✔ 跨线程

• ✔ 非常适合：

  • 日志 TraceId
  • 请求上下文
  • 链路追踪

🧠 OS 级线程 ID（不推荐，特殊场景）

using System.Runtime.InteropServices;

[DllImport("kernel32.dll")]
static extern uint GetCurrentThreadId();

uint osThreadId = GetCurrentThreadId();

特点

• ✔ 和 Win32 / 调试工具一致
• ❗ 仅 Windows
• ❗ P/Invoke，维护成本高
• ❗ 一般业务不需要

🔍 总结对照表

获取逻辑线程独立标识

“逻辑级唯一标识”本质上就是：不关心你在哪个线程上跑，只关心“这是同一次业务/任务/调用链”。

一、直觉理解

线程 ID = 人在哪张椅子上坐着 逻辑 ID = 人是谁

async/await 会“换椅子”，但你还是你。 逻辑级唯一标识就是用来标记“你是谁”。

二、为什么线程 ID 在现代 C# 里不靠谱？

例子：async 方法

async Task DoWorkAsync()
{
    Console.WriteLine(Thread.CurrentThread.ManagedThreadId);
    await Task.Delay(500);
    Console.WriteLine(Thread.CurrentThread.ManagedThreadId);
}

可能输出：

7
12

👉 同一次 DoWorkAsync 调用，却跑在不同线程上

如果你：

• 打日志
• 做链路追踪
• 统计一次任务的耗时
• 在工具/服务层传上下文

线程 ID 会直接把你坑死

三、逻辑级唯一标识的典型使用场景

四、C#：AsyncLocal<T>

AsyncLocal<T> 是 为 async 而生的 ThreadLocal 升级版。

1️⃣ 定义一个逻辑 ID 容器

static class TraceContext
{
    public static AsyncLocal<Guid> TraceId = new();
}

2️⃣ 在“逻辑入口”初始化一次

async Task HandleAsync()
{
    TraceContext.TraceId.Value = Guid.NewGuid();

    await Step1();
    await Step2();
}

3️⃣ 在任意深度的方法里直接用

async Task Step1()
{
    await Task.Delay(100);
    Log("Step1");
}

void Log(string msg)
{
    Console.WriteLine($"[{TraceContext.TraceId.Value}] {msg}");
}

输出效果

[7e2c7c9b-0a7d-4df0-9b89-8b0c88d4a2aa] Step1

👉 线程可能变，TraceId 永远不变

五、对比：为什么不用 ThreadLocal<T>？

六、WinUI / 桌面程序的例子

async void Button_Click(...)
{
    TraceContext.TraceId.Value = Guid.NewGuid();

    await Task.Run(DoHeavyWork);
    UpdateUI();
}

void DoHeavyWork()
{
    Log("后台计算");
}

void UpdateUI()
{
    Log("回到 UI");
}

日志里三步 TraceId 完全一致 哪怕后台和 UI 是不同线程。

七、常见坑

❌ 忘了初始化

TraceContext.TraceId.Value // null / Guid.Empty

✅ 解决：只在入口初始化

❌ 并发污染

Parallel.ForEach(list, item =>
{
    // 共享同一个 TraceId（错）
});

✅ 正确做法：

Parallel.ForEach(list, item =>
{
    TraceContext.TraceId.Value = Guid.NewGuid();
});

八、最佳实践总结（一句话）

线程 ID 用来“调试线程问题” 逻辑 ID 用来“理解业务发生了什么”