Unity 6.3 LTS — 破坏性变更¶

最后验证： 2026-02-13

本文档跟踪 Unity 2022 LTS（可能在模型训练中）与 Unity 6.3 LTS（当前版本）之间的破坏性 API 变更和行为差异，并按风险级别组织。

HIGH RISK — 将破坏现有代码¶

Entities/DOTS API 全面改造¶

版本： Entities 1.0+（Unity 6.0+）

// ❌ OLD (pre-Unity 6, GameObjectEntity pattern)
public class HealthComponent : ComponentData {
    public float Value;
}

// ✅ NEW (Unity 6+, IComponentData)
public struct HealthComponent : IComponentData {
    public float Value;
}

// ❌ OLD: ComponentSystem
public class DamageSystem : ComponentSystem { }

// ✅ NEW: ISystem (unmanaged, Burst-compatible)
public partial struct DamageSystem : ISystem {
    public void OnCreate(ref SystemState state) { }
    public void OnUpdate(ref SystemState state) { }
}

迁移： 请遵循 Unity 的 ECS 迁移指南。需要进行重大的架构变更。

Input System — Legacy Input 已弃用¶

版本： Unity 6.0+

// ❌ OLD: Input class (deprecated)
if (Input.GetKeyDown(KeyCode.Space)) { }

// ✅ NEW: Input System package
using UnityEngine.InputSystem;
if (Keyboard.current.spaceKey.wasPressedThisFrame) { }

迁移： 安装 Input System 包，将所有 Input.* 调用替换为新 API。

URP/HDRP Renderer Feature API 变更¶

版本： Unity 6.0+

// ❌ OLD: ScriptableRenderPass.Execute signature
public override void Execute(ScriptableRenderContext context, ref RenderingData data)

// ✅ NEW: Uses RenderGraph API
public override void RecordRenderGraph(RenderGraph renderGraph, ContextContainer frameData)

迁移： 将自定义渲染通道更新为使用 RenderGraph API。

MEDIUM RISK — 行为变更¶

Addressables — 资源加载返回值¶

版本： Unity 6.2+

资源加载失败现在默认会抛出异常，而不再返回 null。请添加适当的异常处理，或使用 TryLoad 变体。

// ❌ OLD: Silent null on failure
var handle = Addressables.LoadAssetAsync<Sprite>("key");
var sprite = handle.Result; // null if failed

// ✅ NEW: Throws on failure, use try/catch or TryLoad
try {
    var handle = Addressables.LoadAssetAsync<Sprite>("key");
    var sprite = await handle.Task;
} catch (Exception e) {
    Debug.LogError($"Failed to load: {e}");
}

物理系统 — 默认求解器迭代次数已更改¶

版本： Unity 6.0+

默认求解器迭代次数已增加以提高稳定性。如果你依赖旧行为，请检查 Physics.defaultSolverIterations。

LOW RISK — 弃用（仍可使用）¶

UGUI（Legacy UI）¶

状态： 已弃用但仍受支持
替代方案： UI Toolkit

UGUI 仍然可用，但新项目建议使用 UI Toolkit。

旧版粒子系统¶

状态： 已弃用
替代方案： Visual Effect Graph（VFX Graph）

旧版动画系统¶

状态： 已弃用
替代方案： Animator Controller（Mecanim）

平台特定的破坏性变更¶

WebGL¶

• Unity 6.0+：WebGPU 现在为默认设置（可回退到 WebGL 2.0）
• 更新着色器以兼容 WebGPU

Android¶

• Unity 6.0+：最低 API 级别提升至 24（Android 7.0）

iOS¶

• Unity 6.0+：最低部署目标提升至 iOS 13

迁移清单¶

从 2022 LTS 升级到 Unity 6.3 LTS 时：

• [ ] 审核所有 DOTS/ECS 代码（很可能需要完全重写）
• [ ] 将 Input 类替换为 Input System 包
• [ ] 更新自定义渲染通道为 RenderGraph API
• [ ] 为 Addressables 调用添加异常处理
• [ ] 测试物理行为（求解器迭代次数已更改）
• [ ] 考虑将 UGUI 迁移到 UI Toolkit 以用于新 UI
• [ ] 更新 WebGL 着色器以兼容 WebGPU
• [ ] 验证最低平台版本（Android/iOS）

来源：

• https://docs.unity3d.com/6000.0/Documentation/Manual/upgrade-guides.html
• https://docs.unity3d.com/Packages/com.unity.entities@1.3/manual/upgrade-guide.html