XCEngine/docs/api/threading/thread/get-id.md

# Thread::GetId

```cpp
Id GetId() const;
```

返回当前线程对象的唯一标识符。线程 ID 是 `uint64_t` 类型的值，通过 `std::thread::native_handle()` 获取原生线程句柄并转换为整数。

线程 ID 在线程启动后生效。在调用 `Start()` 之前，`GetId()` 返回 0。

**参数：** 无

**返回：** 线程的唯一标识符，线程未启动时返回 0

**线程安全：** ✅

**示例：**

```cpp
#include "XCEngine/Threading/Thread.h"
#include <iostream>

using namespace XCEngine::Threading;

int main() {
    Thread t;
    
    std::cout << "Before Start - Thread ID: " << t.GetId() << std::endl;
    
    t.Start([]() {
        std::cout << "Worker ID: " << Thread::GetCurrentId() << std::endl;
    }, "WorkerThread");
    
    std::cout << "After Start - Thread ID: " << t.GetId() << std::endl;
    
    t.Join();
    return 0;
}
```

## 相关文档

- [Thread 总览](thread.md) - 返回类总览
- [GetCurrentId](getcurrentid.md) - 获取当前执行线程的 ID