Unity 安装
开始学习 Unity 之前,我们需要安装 Unity Hub 和 Unity Editor。
Unity Hub 负责下载编辑器、管理项目和许可证
Unity Editor 才是真正编写 C# 脚本、搭建 3D 场景的软件。
本章节以 Unity 6 国际版为主,介绍 Windows、macOS 的下载安装、账号登录、版本与模块选择,以及创建并运行第一个项目,文章后面单独介绍中国版团结引擎(Tuanjie Engine)的安装,并保留中国版官网下载截图,方便我们根据实际需要选择。
注意:Unity 6 国际版和团结引擎并不是相同的编辑器版本系列。本章节的主要步骤、C# 入门实例和后续学习路线均以 Unity 6 国际版为准。
一、Unity Hub 与 Unity Editor 有什么区别
Unity 的基本安装流程是:下载 Unity Hub → 登录 Unity ID → 安装 Unity 6 Editor → 创建项目 → 运行测试。
| 名称 | 主要作用 | 是否需要 |
|---|---|---|
| Unity Hub | 管理 Unity 编辑器版本、项目、登录和许可证 | 推荐安装,本文以它为入口 |
| Unity Editor | 创建场景、编辑资源、运行游戏、编写和调试 C# | 必须安装 |
| Visual Studio / VS Code / Rider | 编写和调试 C# 脚本 | 建议配置一个 |
| 构建模块 | 支持 Android、iOS、Web 等目标平台 | 根据项目需求安装 |
Unity Hub 可以管理多个 Unity Editor 版本。如果已有项目要求特定版本,可以保留多个编辑器,不必覆盖原有安装。
二、安装前的准备
安装前,我们需要检查操作系统、硬件和磁盘空间。下表属于适合初学者的配置建议,不是 Unity 6 所有版本的最低要求。
| 项目 | 建议 |
|---|---|
| Windows | 使用官方当前支持的 64 位 Windows 10 / Windows 11 |
| macOS | 使用 Unity Hub 与选定 Unity 6 Editor 都支持的 macOS 版本 |
| 内存 | 建议 16GB 或以上;复杂场景可能需要更多 |
| 硬盘空间 | 建议预留至少 30GB,实际与编辑器、构建模块和项目体积有关 |
| 显卡 | 符合选定 Unity 6 Editor 的图形 API 要求 |
| 网络 | 能够访问 Unity 账号登录、编辑器和 Package Manager 服务 |
根据 Unity Hub 官方安装文档,当前 Hub 在 Windows 上支持 Windows 10 21H1 及之后的受支持版本、Windows 11,在 macOS 上要求 macOS 13 Ventura 或之后的受支持版本。Unity Editor 本身还需要另外核对系统要求,不要将 Hub 的要求直接等同于编辑器要求。
系统要求参考:Unity Hub 安装要求。
macOS 如何确认处理器类型
点击苹果菜单中的关于本机,查看芯片或处理器信息:
- M1、M2、M3、M4 等属于 Apple Silicon。
- 较早的 Mac 可能使用 Intel 处理器。
选择 Unity 6 Editor 时,应确认安装版本支持当前架构。
三、下载 Unity Hub(国际版)
打开 Unity 国际版官方下载页面:https://unity.com/download
注意:如果国内的网络会自动跳转到国内的下载页面,设置好海外节点去下载。

- 根据电脑系统下载 Unity Hub 安装包。
- 确认下载地址属于 Unity 官方网站。
- 打开安装程序并按提示完成安装。
- 安装成功后启动 Unity Hub。
页面也提供了安装方法说明:

Windows 安装
运行下载的 Unity Hub 安装包,按提示完成安装,较新的 Unity Hub 在 Windows 上可能采用 MSIX 打包形式,若安装受阻,先检查 Windows 的 App Installer 和系统更新状态。
macOS 安装
打开下载的安装文件,按提示将 Unity Hub 安装到"应用程序"(Applications)目录,再通过应用程序列表或 Launchpad 启动。

如果系统提示安全确认,应先检查安装包是否来自 Unity 官网,再通过 macOS 正常的安全确认流程操作,不需要关闭系统安全保护功能。
四、登录 Unity ID 与激活许可证
首次打开 Unity Hub,需要使用 Unity ID 登录。没有账号的用户,可以通过登录界面创建账号。

对于符合资格的学习者和个人开发者,Unity Personal 是可选择的免费方案。当前 Unity Hub 支持在登录后自动激活符合条件的 Unity Personal 许可证。
- 在 Unity Hub 中登录 Unity ID。
- 打开设置(Settings),进入 Licenses 查看许可证状态。
- 确认账号具有可用的许可证,再继续安装和启动编辑器。

注意:Unity Personal 的免费使用需要满足官方许可资格,企业或商业开发者应根据实际情况核对适用的订阅方案与条款。
官方说明:Unity Hub 许可证管理。
五、安装 Unity 6 Editor
Unity Hub 安装完成后,还需要下载 Unity Editor。我们以 Unity 6 系列为例:
- 打开 Unity Hub,进入 Installs。
- 选择 Install Editor。
- 在版本列表中选择所需的 Unity 6 版本。
- 确认编辑器版本、操作系统支持以及安装位置。
- 根据需要勾选构建模块,然后开始安装。

Unity 6 版本应该怎么选
| 情况 | 建议 |
|---|---|
| 第一次学习 Unity | 优先选择官方当前仍受支持、适合长期使用的 Unity 6 LTS 版本 |
| 跟随指定教程 | 尽量选择与教程一致或兼容的编辑器版本 |
| 打开现有项目 | 先查看原项目的编辑器版本,避免直接升级导致兼容问题 |
| 测试新功能 | 查看对应版本的发行说明与插件兼容性 |
Unity 6 系列采用 6000.x 等版本编号形式。我们不必只因为版本号更高就立即升级正在开发的项目。
六、选择平台构建模块
安装编辑器时,Unity Hub 可能列出多个附加模块。只学习 3D 场景与 C# 脚本时,通常先安装编辑器本身即可。
| 模块 | 用途 | 什么时候安装 |
|---|---|---|
| Unity Editor | 编辑、运行 Unity 项目 | 必须 |
| Visual Studio 等开发工具 | C# 编写与调试 | 建议配置 |
| Android Build Support | 构建 Android 应用 | 开发 Android 项目时 |
| Android SDK & NDK Tools / OpenJDK | Android 构建工具链 | Android 构建时通常需要 |
| iOS Build Support | 构建 iOS 项目 | 开发 iOS 项目时;通常还需要 macOS 与 Xcode |
| Web Build Support | 构建浏览器运行的 Unity 应用 | 需要发布到 Web 时 |
| 其他模块 | 面向其他桌面或专用设备 | 按需安装 |
如何以后补装模块
打开 Installs,找到已安装的编辑器,通过旁边的 Manage → Manage modules 添加所需模块。具体菜单可能随 Hub 版本变化。
官方文档:为 Unity Editor 添加模块。
七、配置 C# 代码编辑器
Unity 主要使用 C# 编写游戏逻辑,常见的代码编辑器包括 Visual Studio、Visual Studio Code 和 JetBrains Rider。
在 Unity Editor 中打开 Preferences / Settings → External Tools,找到 External Script Editor,选择已经安装的编辑器。macOS 的设置入口可能位于 Unity 应用菜单中。
如果使用 VS Code,还需要安装对应的 C# 与 Unity 开发扩展,并确认项目文件能够被正确识别。
配置后,双击 Project 面板中的 C# 脚本,应该能通过指定的编辑器打开。
八、创建第一个 Unity 6 项目
完成 Unity Editor 安装后,可以创建一个空白 3D 项目验证环境。
- 打开 Unity Hub,进入 Projects。
- 点击 New project。
- 选择适合初学者的 3D 模板,例如 Universal 3D(名称可能随版本变化)。
- 项目名称填写
HelloUnity,选择本地保存目录。 - 点击 Create project,等待编辑器初始化项目。
建议将项目保存在具有读写权限、磁盘空间充足的目录。第一次创建项目可能需要导入资源与编译脚本。
认识主要编辑器面板
| 面板 | 作用 |
|---|---|
| Scene | 编辑场景和摆放模型 |
| Game | 查看摄像机输出的游戏画面 |
| Hierarchy | 查看场景对象的层级关系 |
| Inspector | 设置对象的位置、组件与属性 |
| Project | 管理脚本、场景、模型和材质文件 |
| Console | 查看日志、警告和编译错误 |
九、运行第一个 Unity C# 实例
下面通过一个自动旋转的立方体检查脚本是否正常编译和执行。
- 在 Hierarchy 中选择 GameObject → 3D Object → Cube,创建立方体。
- 在 Assets 中创建 C# MonoBehaviour 脚本,命名为
RotateCube.cs。 - 将以下代码复制到脚本中并保存。
- 把脚本拖到 Cube 的 Inspector 面板上,作为组件添加。
- 点击编辑器顶部的 Play 按钮。
实例:Unity 6 旋转立方体
public class RotateCube : MonoBehaviour
{
// 旋转速度,单位:度/秒
public float speed = 60f;
void Update()
{
transform.Rotate(
Vector3.up,
speed * Time.deltaTime
);
}
}
如果运行后立方体持续旋转,说明 C# 脚本已经正常工作。Update() 在运行期间逐帧执行,Time.deltaTime 可以让旋转速度不直接取决于帧率。
如果看不到立方体,请检查 Camera 位置、Cube 是否启用,以及 Console 是否存在编译错误。
说明:Unity C# 脚本必须在 Unity Editor 的项目环境中运行,不能直接放进普通 HTML 的 JavaScript 运行器执行,因此这里不添加"尝试一下"网页链接。
十、中国版团结引擎安装
如果项目需要使用 Unity 中国提供的团结引擎(Tuanjie Engine),应访问中国版下载页面,而不是使用前文 Unity 6 国际版的安装路径。
团结引擎官方网站:https://unity.cn/tuanjie/releases
团结引擎和 Unity 6 国际版属于不同的产品及版本发布线。编辑器功能、可用模块、许可证、平台支持和部分插件兼容性可能存在差异。

| 电脑类型 | 如何选择 |
|---|---|
| Windows 64 位 | 点击 Windows 一栏的"下载" |
| macOS Intel | 打开 macOS 下载菜单,选择"Intel 芯片" |
| macOS Apple Silicon(M1、M2、M3、M4 等) | 打开 macOS 下载菜单,选择"Apple 芯片" |
为什么会有旧版团结 Hub? 主要是为了让需要兼容旧工作流或已有项目的开发者继续使用对应的管理工具。它不是要求新用户安装的必备组件,也不等于"旧版 Unity 6"。
3、安装与创建项目
- 根据系统和芯片类型下载团结 Cowork 安装包。
- 按照 Windows 或 macOS 的安装提示完成安装。
- 启动团结 Cowork,按照客户端提示登录并确认相应许可证。
- 在客户端选择团结引擎编辑器版本,按需安装目标平台模块。
- 新建 3D 项目,再打开编辑器进行开发。
团结引擎的版本编号与 Unity 6 的 6000.x 并不一一对应。若需要与 Unity 6 国际版教程保持完全一致,仍建议安装前文介绍的 Unity Hub 和 Unity 6 Editor。
十一、安装常见问题
| 问题 | 排查方法 |
|---|---|
| Unity Hub 无法登录 | 检查网络、浏览器登录回跳、系统时间、防火墙和账号状态 |
| 编辑器下载失败 | 确认安装目录可写、磁盘空间充足,并在 Hub 中查看下载错误 |
| Unity Editor 无法启动 | 核对系统要求、显卡驱动、许可证和安装完整性 |
| 项目创建缓慢 | 首次导入资源可能较慢;检查磁盘与 Package Manager 网络 |
| C# 没有代码补全 | 检查 External Script Editor、IDE 扩展和 Unity 项目集成 |
| 无法构建 Android / Web | 确认已经安装对应编辑器版本的构建模块 |
| 教程菜单与自己不同 | 查看 Unity Hub / Editor 版本,确认是不是误装了中国版团结引擎 |
遇到项目问题时,不建议一开始就删除整个项目或 Library 缓存。优先读取 Console 和编辑器日志,确认错误来源,再选择处理方式。
安装完成后学习什么
建议从 Unity 编辑器、GameObject、Component 和 C# MonoBehaviour 开始,再逐步学习材质、光照、物理和动画。
| 学习阶段 | 内容 |
|---|---|
| 基础操作 | Scene、Hierarchy、Inspector、Project |
| C# 脚本 | Start、Update、Transform、Time.deltaTime |
| 场景与材质 | Camera、Light、Material、Prefab |
| 交互和物理 | Input System、Rigidbody、Collider |
| 综合实战 | 制作、运行并构建一个简单的小游戏 |
参考资料
Unity 国际版下载:https://unity.com/download
Unity Hub 安装说明:https://docs.unity.com/en-us/hub/install-hub-win-mac
Unity Editor 安装管理:https://docs.unity.com/en-us/hub/add-editor
构建模块管理:https://docs.unity.com/en-us/hub/add-modules
Unity 许可证:https://docs.unity.com/en-us/hub/manage-license
中国版团结引擎下载:https://unity.cn/tuanjie/releases
