本页目录
官方资料整理 Windows macOS Linux

Unity 开发与测试环境部署

通过 Unity Hub 安装编辑器与模块,打开现有工程并进入 Play Mode 做冒烟运行。

适用项目: 引擎通用(暂未关联具体项目)

工具版本:Unity Hub 3.x、Unity 2022.3 LTS 或 Unity 6

未标注「站长实测」的步骤请自行核验。

本篇为 Unity 通用环境教程,不绑定具体游戏。依据 Unity 手册 与 Hub 安装流程整理;请以仓库 ProjectSettings/ProjectVersion.txt 中的编辑器版本为准。

国内网络下载编辑器较慢时,可使用 Unity 中国 Hub / 镜像说明,或提前用稳定网络完成安装。

1. 安装 Unity Hub 与编辑器

  1. 安装 Unity Hub。
  2. 登录 Unity 账号后,在 Hub → Installs → Install Editor 安装与目标项目匹配的版本(优先 LTS)。
  3. 安装时勾选需要的模块,例如:
    • Windows Build Support(IL2CPP)
    • 文档 / 语言包(可选)
    • 若项目含 Android/iOS,再补对应 Build Support
  4. Windows 还需安装 Visual Studio 或 VS Code,并勾选「使用 Unity 的游戏开发」工作负载(Hub 通常会提示)。

2. 打开现有工程

  1. Hub → Projects → Open,选择含 Assets、ProjectSettings 的工程根目录。
  2. 若版本不一致,Hub 会提示用当前编辑器升级或另装匹配版本;开源跟做优先安装仓库指定版本,避免静默升级破坏脚本 API。
  3. 首次打开会导入资源,耗时与工程体积有关,等待进度完成。

3. Play Mode 冒烟与常见错误

  1. 打开 README 指定的启动场景(Assets/.../*.unity),点击编辑器中部 Play。
  2. 看 Console 窗口:红色报错需先解决(缺 using、程序集定义、包版本)。
  3. 常见问题:
    • Package Manager 依赖失败:Window → Package Manager,对照 Packages/manifest.json。
    • 渲染管线不匹配:确认 URP/HDRP/Built-in 与项目一致。
    • 输入无响应:检查新 Input System 与 Player Settings。

4. 命令行与批量验证(可选)

CI 或本机批量冒烟可使用编辑器命令行模式(路径按本机安装修改):

Unity.exe -batchmode -projectPath <工程路径> -quit -logFile -

官方说明:Unity Editor command line arguments