XCEngine/docs/api/threading/thread/join.md

# Thread::Join

```cpp
void Join();
```

等待线程执行完成并回收其资源。调用 `Join()` 会阻塞当前线程，直到目标线程结束运行。如果目标线程已经结束或从未启动，则此调用立即返回。

`Join()` 只能调用一次。在调用 `Join()` 后，`std::thread` 对象不再代表任何线程，不能再次调用 `Join()` 或 `Detach()`。

析构函数会自动调用 `Join()`，确保线程对象销毁前等待线程结束。

**注意：** 如果线程已经被分离（Detach）或已经 Join 过，调用此方法将导致未定义行为。

**参数：** 无

**返回：** 无

**线程安全：** ❌

**示例：**

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

using namespace XCEngine::Threading;

int main() {
    Thread t;
    t.Start([]() {
        for (int i = 0; i < 3; ++i) {
            std::cout << "Working... " << i << std::endl;
            Thread::Sleep(100);
        }
    }, "WorkerThread");
    
    std::cout << "Waiting for thread to complete..." << std::endl;
    t.Join();
    std::cout << "Thread completed!" << std::endl;
    return 0;
}
```

## 相关文档

- [Thread 总览](thread.md) - 返回类总览