本页目录
官方资料整理
Windows
macOS
Linux
Unity 开发与测试环境部署
通过 Unity Hub 安装编辑器与模块,打开现有工程并进入 Play Mode 做冒烟运行。
本篇为 Unity 通用环境教程,不绑定具体游戏。依据 Unity 手册 与 Hub 安装流程整理;请以仓库 ProjectSettings/ProjectVersion.txt 中的编辑器版本为准。
国内网络下载编辑器较慢时,可使用 Unity 中国 Hub / 镜像说明,或提前用稳定网络完成安装。
1. 安装 Unity Hub 与编辑器
- 安装 Unity Hub。
- 登录 Unity 账号后,在 Hub → Installs → Install Editor 安装与目标项目匹配的版本(优先 LTS)。
- 安装时勾选需要的模块,例如:
- Windows Build Support(IL2CPP)
- 文档 / 语言包(可选)
- 若项目含 Android/iOS,再补对应 Build Support
- Windows 还需安装 Visual Studio 或 VS Code,并勾选「使用 Unity 的游戏开发」工作负载(Hub 通常会提示)。
2. 打开现有工程
- Hub → Projects → Open,选择含
Assets、ProjectSettings的工程根目录。 - 若版本不一致,Hub 会提示用当前编辑器升级或另装匹配版本;开源跟做优先安装仓库指定版本,避免静默升级破坏脚本 API。
- 首次打开会导入资源,耗时与工程体积有关,等待进度完成。
3. Play Mode 冒烟与常见错误
- 打开 README 指定的启动场景(
Assets/.../*.unity),点击编辑器中部 Play。 - 看 Console 窗口:红色报错需先解决(缺 using、程序集定义、包版本)。
- 常见问题:
- Package Manager 依赖失败:
Window → Package Manager,对照Packages/manifest.json。 - 渲染管线不匹配:确认 URP/HDRP/Built-in 与项目一致。
- 输入无响应:检查新 Input System 与 Player Settings。
- Package Manager 依赖失败:
4. 命令行与批量验证(可选)
CI 或本机批量冒烟可使用编辑器命令行模式(路径按本机安装修改):
Unity.exe -batchmode -projectPath <工程路径> -quit -logFile -