Unity Engine — 版本参考¶

Knowledge Gap 警告¶

LLM 的训练数据很可能只覆盖到约 2022 LTS（2022.3）版本的 Unity。整个 Unity 6 发布系列（原 Unity 2023 Tech Stream）引入了大量该模型不知道的重大变更。在提出任何 Unity API 调用建议之前，请始终交叉参考本目录。

已安装版本差距警告¶

上述警告是单向的——它描述的是模型比此固定版本知道得更少。反向差距同样真实存在，而 /setup-engine §3 有意制造了这种情况（“先固定较新版本，之后再升级”）：本参考可能领先于已安装的编辑器，代理如果正确引用了它，随后输出的 API 在本地可能无法编译。在信任任何带版本限定的声明之前，请先检查上方的 Installed at pin time——NOT DETERMINED 表示差距未知，而非不存在。

截止后版本时间线¶

⚠ 此表内部不一致，在重新核验之前，不得用于 RISK 判断（标记时间 2026-08-10）。 它的标题为 Post-Cutoff（截止后），而上方声明的截止日期是 2025 年 5 月，但表中四行里有三行的日期是 2024 年 10 月、11 月和 12 月——早于该截止日期——之后又隔了十二个月才到 2025 年 12 月的 6.3。这两者不可能同时成立。同级文件 godot/VERSION.md 和 unreal/VERSION.md 只列出了真正截止后发布的版本，因此这是本文件的缺陷，而不是格式的问题。

为什么这比一个错误的日期更严重。 此表的全部作用就是告诉代理它尚未知道的内容。早于截止日期的行会反转这一信号：以已安装的 6000.1.0f1（Unity 6.1）为例——本表将其标为 2024 年 11 月，并标记为截止后 MEDIUM 风险，而按照该表自己的截止日期，2024 年 11 月的发布应属于训练数据之内。阅读此表的代理要么过度信任参考，要么错误评估哪些是新内容，而且本目录其他地方引用的 6.2+ 边界也锚定在这些行上。

这里故意不修正日期。 真实的 Unity 发布日期无法从本仓库获取——本目录就是来源——而根据训练数据写出来，正是整个目录存在所要防止的失败（/security-audit 也做出了同样的判断）。请对照 Unity 公开发布的版本说明重新核验，并同时更新表格中的日期、Release Date 字段和 Last Docs Verified。在此之前，请将 docs/engine-reference/unity/ 中所有带版本限定的声明视为未确认，并优先选择不依赖版本边界的 API。

从 2022 LTS 到 Unity 6.3 LTS 的主要变更¶

破坏性变更¶

• Entities/DOTS：Entities 1.0+ 中 API 大规模重构，ECS 模式完全重新设计
• Input System：Legacy Input Manager 已弃用，新版 Input System 成为默认
• Rendering：URP/HDRP 显著升级，SRP Batcher 改进
• Addressables：资产管理流程变更
• Scripting：支持 C# 9，新的 API 模式

新功能（截止后）¶

• DOTS：生产就绪的实体组件系统（Entities 1.3+）
• Graphics：增强的 URP/HDRP 渲染管线，GPU Resident Drawer
• Multiplayer：Netcode for GameObjects 改进
• UI Toolkit：可用于运行时 UI 的生产级解决方案（新项目取代 UGUI）
• Async Asset Loading：改进的 Addressables 性能
• Web：WebGPU 支持

已弃用的系统¶

• Legacy Input Manager：请使用新版 Input System 包
• Legacy Particle System：请使用 Visual Effect Graph
• UGUI：仍受支持，但新项目推荐使用 UI Toolkit
• 旧版 ECS（GameObjectEntity）：已被现代 DOTS/Entities 取代

已验证来源¶

• 官方文档：https://docs.unity3d.com/6000.0/Documentation/Manual/index.html
• Unity 6 发布：https://unity.com/releases/unity-6
• Unity 6.3 LTS 公告：https://unity.com/blog/unity-6-3-lts-is-now-available
• 迁移指南：https://docs.unity3d.com/6000.0/Documentation/Manual/upgrade-guides.html
• Unity 6 支持：https://unity.com/releases/unity-6/support
• C# API 参考：https://docs.unity3d.com/6000.0/Documentation/ScriptReference/index.html