XCEngine/docs/api/XCEngine/Components/GameObject/AddComponent.md

# GameObject::AddComponent

为当前对象添加一个普通组件，或返回已有的内建 `Transform`。

```cpp
template<typename T, typename... Args>
T* AddComponent(Args&&... args);
```

## 行为说明

当前模板实现分两条路径：

- 如果 `T` 继承自 `TransformComponent`
  - 直接返回已有 `m_transform`
  - 不会创建第二个 `Transform`
- 否则
  - 构造一个新的组件实例
  - 回填 `component->m_gameObject = this`
  - 放入 `m_components`
  - 返回新组件指针

## 当前不会自动发生什么

运行时添加普通组件时，当前实现**不会自动补发**：

- `Awake()`
- `Start()`
- `OnEnable()`

这是当前对象系统最重要的现实边界之一。组件挂载完成，不等于它已经追平生命周期进度。

## 所有权语义

- 普通组件的所有权由 `GameObject` 内部 `std::unique_ptr<Component>` 接管
- 返回值只是观察指针
- 调用方不应自行 `delete`

## 相关文档

- [GameObject](GameObject.md)
- [GetComponent](GetComponent.md)
- [RemoveComponent](RemoveComponent.md)
- [GetTransform](GetTransform.md)