Unity 6.3 LTS — 已弃用的 API¶

最后验证： 2026-02-13

已弃用 API 及其替代方法的快速查找表。格式：不要使用 X → 改用 Y

输入¶

已弃用	替代方法	说明
`Input.GetKey()`	`Keyboard.current[Key.X].isPressed`	New Input System
`Input.GetKeyDown()`	`Keyboard.current[Key.X].wasPressedThisFrame`	New Input System
`Input.GetMouseButton()`	`Mouse.current.leftButton.isPressed`	New Input System
`Input.GetAxis()`	`InputAction` 回调	New Input System
`Input.mousePosition`	`Mouse.current.position.ReadValue()`	New Input System

迁移： 安装 com.unity.inputsystem 包。

UI¶

已弃用	替代方法	说明
`Canvas` (UGUI)	`UIDocument` (UI Toolkit)	UI Toolkit 现已可用于生产环境
`Text` 组件	`TextMeshPro` 或 UI Toolkit `Label`	更好的渲染，更少的绘制调用
`Image` 组件	UI Toolkit `VisualElement`（带背景）	更灵活的样式

迁移： UGUI 仍然可用，但新项目推荐使用 UI Toolkit。

DOTS/Entities¶

已弃用	替代方法	说明
`ComponentSystem`	`ISystem`（非托管）	Entities 1.0+ 完全重写
`JobComponentSystem`	带 `IJobEntity` 的 `ISystem`	兼容 Burst
`GameObjectEntity`	纯 ECS 工作流	无需 GameObject 转换
`EntityManager.CreateEntity()`（旧签名）	`EntityManager.CreateEntity(EntityArchetype)`	显式 Archetype
`ComponentDataFromEntity<T>`	`ComponentLookup<T>`	Entities 1.0+ 更名

迁移： 参见 Entities 包迁移指南。需要进行重大重构。

渲染¶

已弃用	替代方法	说明
`CommandBuffer.DrawMesh()`	RenderGraph API	URP/HDRP 渲染通道
`OnPreRender()` / `OnPostRender()`	`RenderPipelineManager` 回调	SRP 兼容性
`Camera.SetReplacementShader()`	自定义渲染通道	在 SRP 中不受支持

物理¶

已弃用	替代方法	说明
`Physics.RaycastAll()`	`Physics.RaycastNonAlloc()`	避免 GC 分配
`Rigidbody.velocity`（直接写入）	`Rigidbody.AddForce()`	更好的物理稳定性

资源加载¶

已弃用	替代方法	说明
`Resources.Load()`	Addressables	更好的内存控制，异步加载
同步资源加载	`Addressables.LoadAssetAsync()`	非阻塞

动画¶

已弃用	替代方法	说明
Legacy Animation 组件	Animator Controller	Mecanim 系统
`Animation.Play()`	`Animator.Play()`	状态机控制

粒子系统¶

已弃用	替代方法	说明
Legacy Particle System	Visual Effect Graph	GPU 加速，性能更高

脚本¶

已弃用	替代方法	说明
`WWW` 类	`UnityWebRequest`	现代异步网络通信
`Application.LoadLevel()`	`SceneManager.LoadScene()`	场景管理

特定平台¶

WebGL¶

已弃用	替代方法	说明
WebGL 1.0	WebGL 2.0 或 WebGPU	Unity 6+ 默认使用 WebGPU

快速迁移模式¶

输入示例¶

// ❌ Deprecated
if (Input.GetKeyDown(KeyCode.Space)) {
    Jump();
}

// ✅ New Input System
using UnityEngine.InputSystem;
if (Keyboard.current.spaceKey.wasPressedThisFrame) {
    Jump();
}

资源加载示例¶

// ❌ Deprecated
var prefab = Resources.Load<GameObject>("Enemies/Goblin");

// ✅ Addressables
var handle = Addressables.LoadAssetAsync<GameObject>("Enemies/Goblin");
await handle.Task;
var prefab = handle.Result;

UI 示例¶

// ❌ Deprecated (UGUI)
GetComponent<Text>().text = "Score: 100";

// ✅ TextMeshPro
GetComponent<TextMeshProUGUI>().text = "Score: 100";

// ✅ UI Toolkit
rootVisualElement.Q<Label>("score-label").text = "Score: 100";

来源：

https://docs.unity3d.com/6000.0/Documentation/Manual/deprecated-features.html
https://docs.unity3d.com/Packages/com.unity.inputsystem@1.11/manual/Migration.html

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/Claude-Code-Game-Studios