环境配置
本章将指导你完成 Unity 开发环境的安装和配置,包括 Unity Hub、Unity 编辑器以及必要的开发工具。
系统要求
最低配置
| 组件 | Windows | macOS |
|---|---|---|
| 操作系统 | Windows 10 (64-bit) | macOS 10.13+ |
| 处理器 | x64 架构,支持 SSE2 | Apple Silicon 或 Intel x64 |
| 内存 | 4 GB RAM | 4 GB RAM |
| 显卡 | DX10、DX11、DX12 兼容 | Metal 兼容 |
| 存储空间 | 10 GB 可用空间 | 10 GB 可用空间 |
推荐配置
- 内存:16 GB 或更多(大型项目需要)
- 显卡:支持 DX12 或 Metal 的独立显卡
- 存储:SSD,50 GB 以上可用空间
- 显示器:1920×1080 或更高分辨率
安装 Unity Hub
Unity Hub 是管理 Unity 项目和编辑器版本的核心工具,所有 Unity 开发都应从安装 Unity Hub 开始。
Windows 安装
- 访问 Unity 官网下载页面
- 点击 Download Unity Hub 按钮
- 运行下载的
UnityHubSetup.exe - 按照安装向导完成安装
macOS 安装
- 访问 Unity 官网下载页面
- 下载
UnityHubSetup.dmg - 打开 DMG 文件,将 Unity Hub 拖到 Applications 文件夹
Linux 安装
Unity Hub 也支持 Linux,可从官网下载 AppImage 格式:
# 下载后赋予执行权限
chmod +x UnityHub.AppImage
./UnityHub.AppImage
创建 Unity 账号
使用 Unity 需要注册一个 Unity ID:
- 打开 Unity Hub
- 点击右上角 Sign in 或 Create account
- 填写邮箱、密码等信息完成注册
- 验证邮箱
许可证选择
- Personal(个人版):年收入低于 10 万美元可免费使用
- Plus/Pro:商业项目需要购买许可证
安装 Unity 编辑器
通过 Unity Hub 安装
- 打开 Unity Hub
- 点击左侧 Installs(安装)标签
- 点击右上角 Install Editor 按钮
- 选择版本:
- 推荐选择最新的 LTS(长期支持)版本
- 本教程基于 Unity 6 (6000.x) LTS
- 选择模块(Modules):
- Windows/Mac/Linux Build Support:桌面平台支持
- Android Build Support:Android 开发
- iOS Build Support:iOS 开发(macOS 必需)
- WebGL Build Support:网页游戏
- Documentation:离线文档
- Language Pack (Chinese):中文语言包
安装路径建议
C:\Program Files\Unity\Hub\Editor\
├── 6000.0.xf1\ # Unity 6 LTS
├── 2022.3.xf1\ # Unity 2022 LTS
└── ...
配置开发环境
安装 Visual Studio(推荐)
Visual Studio 是 Unity 开发的最佳 IDE,提供智能提示、调试等功能。
- 下载 Visual Studio Community
- 运行安装程序,选择工作负载:
- 使用 Unity 的游戏开发(必须)
- .NET 桌面开发(可选)
配置 Unity 与 Visual Studio 关联
- 打开 Unity 编辑器
- 菜单栏选择 Edit > Preferences(Windows)或 Unity > Settings(macOS)
- 选择 External Tools 标签
- External Script Editor 选择 Visual Studio
- 勾选 Generate .csproj files 下的所有选项
使用 Visual Studio Code(轻量选择)
如果你更喜欢轻量级编辑器:
- 安装 VS Code
- 安装扩展:
- C# Dev Kit
- Unity
- 在 Unity 中设置 External Script Editor 为 VS Code
创建第一个项目
新建项目步骤
- 打开 Unity Hub
- 点击左侧 Projects 标签
- 点击右上角 New Project 按钮
- 选择模板:
- 3D Core:标准 3D 项目
- 3D URP:通用渲染管线项目(推荐)
- 2D (URP):2D 项目
- 2D Core:传统 2D 项目
- 设置项目名称和位置
- 点击 Create Project
项目结构说明
创建项目后,你会看到以下文件结构:
MyFirstGame/ # 项目根目录
├── Assets/ # 资源文件夹(所有游戏资源)
│ ├── Scenes/ # 场景文件
│ ├── Scripts/ # 脚本文件
│ ├── Prefabs/ # 预制体
│ └── ...
├── Packages/ # 包管理文件
├── ProjectSettings/ # 项目设置
├── UserSettings/ # 用户个人设置
└── Logs/ # 日志文件
重要提示
- Assets 文件夹是唯一需要版本控制的文件夹
- 不要在资源管理器中移动 Assets 内的文件,应在 Unity 编辑器内操作
常见问题解决
Unity Hub 无法启动
问题:双击 Unity Hub 无反应
解决方案:
- 检查系统是否满足最低要求
- 尝试以管理员身份运行
- 删除配置文件夹后重启:
- Windows:
%APPDATA%\UnityHub - macOS:
~/Library/Application Support/UnityHub
- Windows:
编辑器安装失败
问题:下载或安装编辑器时出错
解决方案:
- 检查网络连接
- 暂时关闭杀毒软件
- 手动下载编辑器安装包从官网
- 通过 Unity Hub 的 Locate 功能指向已下载的安装
Visual Studio 无法调试
问题:无法在 VS 中设置断点或调试
解决方案:
- 确保安装了 "使用 Unity 的游戏开发" 工作负载
- 在 Unity 中确认 External Script Editor 设置正确
- 尝试重新生成项目文件:Assets > Open C# Project
中文显示问题
问题:界面中文显示乱码或不全
解决方案:
- 确保安装了中文语言包模块
- 在 Preferences > Language 中选择简体中文
- 重启编辑器
验证安装
完成安装后,进行以下验证:
-
创建测试项目:
- 新建 3D URP 项目
- 等待项目加载完成
-
测试脚本编辑:
- 在 Assets 文件夹右键 > Create > C# Script
- 命名为
TestScript - 双击打开,确认能正常在 VS/VS Code 中打开
-
运行场景:
- 点击播放按钮(▶)
- 确认 Game 视图正常显示
- 再次点击停止播放
-
构建测试:
- File > Build Settings
- 选择 PC, Mac & Linux Standalone
- 点击 Build 测试是否能成功构建
下一步
环境配置完成后,你可以:
- 学习 编辑器界面 了解各窗口功能
- 创建你的第一个游戏对象
- 开始编写 C# 脚本