前言：为什么"搭环境"也能决定游戏上架还是下架
如果你问一个 Unity 老鸟，项目失败最常见的"非技术"原因是什么？答案大概率不是算法不行，也不是美术拉胯，而是"环境炸了"！比如，2019 年某独立团队，离上架 Steam 仅 72 小时，因 Package Manager 代理抽风，下载不了 Addressable，被迫回退版本，错过夏季促销；又如，2022 年某大厂 VR 项目，因 M1 芯片与 Intel 插件混用，构建的 APK 在 Quest 2 里帧率直接腰斩，回炉三个月；再如，2023 年全球 Game Jam，冠军作品因 Collaborate 历史记录过胖，72 小时极限压缩后仍超 1 GB，当场被判超时。这些血淋淋的事实告诉我们，环境搭建不是"Hello World"式的过场动画，而是持续整个生命周期的隐藏 Boss。Unity 迭代到 2025 LTS，官方推出了云端构建、CoreCLR、DOTS 1.0、Device Simulator 3.0 等新神器，也带来了新的坑位。那么本文就来详细介绍一线商业项目验证，目标只有一个：让你一次搭好、终身不乱、团队不吵、上线不炸。
Unity开发前的"兵马未动，粮草先行"
俗话说得好：欲先善其事，必先利其器。做开发也是一样，搭环境及环境配置是开发的第一步，而且不同的操作系统对应的开发环境配置也不太相同。关于Unity开发的环境搭建，这里从三个不同环境来分享，具体如下所示。
1、系统选型与硬件最低配置
（1）Win 平台：为什么依然推荐 Win11 22H2
在 Windows 平台中，目前依然推荐选择 Win11 22H2 版本，核心原因在于其在功能实用性与兼容性上的出色表现：在内核隔离方面，该版本的 VBS（虚拟安全模式）默认处于关闭状态，同时支持用户手动开启，这种灵活的设置使其能够很好地兼容 Anti-Cheat（反作弊）程序，有效避免了像《永劫无间》这类游戏在开发机上出现无法调试的问题，为游戏开发工作提供了便利；在 WSL2（Windows 子系统 Linux 版）功能上，Win11 22H2 自带 GUI（图形用户界面），这一特性让用户可直接运行 Linux 版的 Unity Headless Build，仅需一条命令就能完成服务器包的打包操作，彻底省去了使用双系统时频繁重启的麻烦，大幅提升了跨系统开发与操作的效率；而从硬件配置需求来看，结合 2025 LTS 版本空载状态下的实测数据，Win11 22H2 的最低配置要求为 CPU 选择 8 核 16 线程，且需是 Intel 11 代或 AMD Zen3 及以上型号，这样的配置要求既符合当前主流硬件水平，也能保障系统稳定运行。
（2）macOS：M系列芯片的 Rosetta 陷阱
在搭载 M 系列芯片的 macOS 设备使用过程中，存在着与 Rosetta 相关的两类常见陷阱，需要使用者特别注意：一方面，尽管 Unity 原生 ARM 版本已正式发布，但目前绝大多数常用插件（如 Spine、FMOD）仍为 x86_64 架构，若未在 Unity 的 Player Settings 中勾选 "Open using Rosetta" 选项，在进行 IL2CPP 链接操作时会出现 "ld: symbol (s) not found" 的错误提示，导致相关开发工作无法正常推进；另一方面，Xcode 15 版本默认启用 "ENABLE_USER_SCRIPT_SANDBOX=YES" 设置，该设置会导致 PostBuild 脚本无法写入 DerivedData 目录，若未在 Podfile 内显式关闭这一默认设置，会造成云构建过程卡顿长达 20 分钟，严重影响开发效率。
（3）云开发机：UCloud vs 阿里云 GPU 机型
这里得出一个结论：长期 CI 选 UCloud，短期活动选阿里云（因为优惠券多）。
2、Unity Hub安装
接下来介绍Unity Hub安装的步骤，这里主要是关于windows系统和MacOS系统的安装步骤介绍。
（1）Windows系统
Windows系统安装Unity工具，首先访问Unity官网（https://unity.cn/）并找到下载按钮，接着下载Unity Hub安装包，随后以管理员身份运行该安装程序，最后根据安装界面提示逐一完成操作，即可顺利完成Unity Hub的安装，官网有详细的教程步骤介绍，这里不再赘述。
（2）macOS系统
在macOS系统下安装Unity Hub，可先下载对应版本的Unity Hub for Mac，下文会在"示例：基于Mac系统的详细安装步骤"这一部分中详细介绍。需要注意的是首次运行时，需允许相关安全权限并输入开机密码进行验证，验证通过后，便可正常开展后续安装操作。
3、IDE 配置：Rider 2024.3 与 VS Code 1.89 双剑合璧
关于IDE的配置，具体如下所示。
（1）Debugger 端口映射
* Rider 内置 Unity Debug 端口 56000，需在 Editor Preferences → Debugger 勾选 Allow remote debugging。
* VS Code 使用 Unity Debugger Extension v0.3.0，支持 Attach 模式，断点命中后 Watch 窗口可查看 NativeArray<T> 内容。（2）Roslyn Analyser 与 Burst 编译联动
接着在 Assets/csc.rsp 添加 -analyzer:Assets/Analyzers/BurstAnalyzer.dll，可实时提示 BurstCompile 方法内不能使用 foreach 等 GC Alloc 代码。
（3）EditorConfig 统一格式化
直接在根目录放置 .editorconfig，如下所示：
[*.cs]
indent_style = space
indent_size = 4
charset = utf-8最后在提交时 pre-commit 钩子自动 dotnet format，杜绝 MR 因空格打架。
4、团队协作"十二公约"
最后再来分享一下关于团队协作的内容。
- 编码规范：命名用 Pascal，字段用 camel，文件同名类名。
- 资源导入三审：美术 → 技术美术 → 客户端，防止 4K 纹理直接塞进手机包。
- 场景合并冲突：使用 UnityYAMLMerge 指定为 Git mergetool，自动解决 90% 序列化冲突。
- 重构禁令：版本冻结前 7 天禁止大型重构，避免 QA 回归测试爆炸。
- 版本号规则：年.月.日.小时，如 25.05.18.14，CI 自动写入PlayerSettings.bundleVersion。
示例：基于Mac系统的Unity详细安装步骤
接下来以Mac OS系统为例详细的图示一下关于Unity的环境搭建，具体如下所示。
1、Mac OS系统
具体电脑配置如下截图所示，不再赘述：
2、关于 Unity的安装
关于Unity的安装，我们可以直接在官网（https://unity.cn/）下载Unity Hub，然后使用Unity Hub安装对应版本的Unity版本即可，这一步与Windows系统的下载步骤一致。
3、开发编辑器（VS Code）
关于VS Code下载和安装，其实做Unity开发用的编辑器不仅可以用VS Code，还可以用Visual Studio，由于个人喜好原因我更喜欢VS Code编辑器，所以这里就介绍VS Code的下载和安装步骤。直接去VS Code官网下载对应的Mac版，官网如下：https://code.visualstudio.com/
关于VS Code编辑器的下载和安装步骤这里就不再过多赘述，大家可以按照提示直接安装就行。
4、下载安装VS Code插件
安装完VS Code之后，就是要安装VS Code的插件，让VSCode作为Unity的代码编辑器，下面介绍一下需要安装的插件。
（1）unity3d插件
(2)其他插件
如果我们的项目有使用lua，还需要安装一下lua相关的插件，一般安装的是：EmmyLua和Lua两个插件。
为了方便查看我们工程的目录结构，需要再安装一个vscode-icons插件。
另外，如果我们需要代码自动补全，需要安装Mono，mono的下载链接：https://www.mono-project.com/download/stable/
5、安装.NET Core SDK
直接通过brew来安装.net sdk，需要注意的是如果你Mac没有装brew，电脑可能会提示brew命令不存在，你需要安装一下HomeBrew。
具体的brew安装.net sdk的命令行如下所示：
brew install dotnet
6、设置External Script Editor为VSCode
也就是把Unity的External Script Editor设置为Visual Studio Code。安装完毕之后就可以通过VSCode来写代码了。
7、安装JRE
由于有些程序需要依赖Java运行环境，所以我们需要安装JRE，官网下载链接：https://www.java.com/zh-CN/download/
8、安装adb
如果我们需要安卓设备进行调试，我们一般会使用adb命令来安装apk和查看日志，在mac中，可以使用brew来安装adb，按照命令如下所示：
brew install --cask android-platform-tools另外安装安卓模拟器，直接去网上下载安卓模拟器，我为了以后使用方便，我直接下载一个 Android Studio及安卓模拟器。
Rokid AR SDK集成配置
接下来分享一下Rokid AR SDK集成配置的设置步骤，具体如下所示。
1、Rokid SDK下载与导入
（1）获取SDK
需要先去访问Rokid开发者官网 https://www.rokid.com/，然后注册开发者账号，接着去下载最新版本的Unity SDK包（.unitypackage文件）
（2）导入SDK
直接在Unity中创建新项目或打开现有项目，然后进行Assets → Import Package → Custom Package操作，选择下载的Rokid SDK .unitypackage文件，但是确保所有文件都被勾选，点击Import即可。
2、Rokid项目配置
上面关于SDK下载和导入之后，接着就是配置项，具体如下所示。
（1）Player Settings配置
操作入口File → Build Settings → Player Settings，设置Company Name：公司名称、Product Name：应用名称、Package Name：反向域名格式，比如：com.yourcompany.yourapp）
（2）Android平台特殊配置
关于安卓平台的一些特别配置，需要切换平台到Android（Build Settings → Android → Switch Platform），然后Player Settings → Android Settings，具体设置如下所示：
- Minimum API Level：Android 7.0 (API Level 24)
- Target API Level：Android 11 (API Level 30) 或更高
- Scripting Backend：IL2CPP
- Target Architectures：ARM64（必须勾选）
（3）XR设置
接着是关于XR设置，直接从 Window → Package Manager进入，搜索并安装"XR Plugin Management"，然后Project Settings → XR Plug-in Management，需要勾选Rokid XR Provider（如果SDK包含）即可。
3、Rokid特定组件配置
（1）场景设置
这里需要注意的是，删除默认的Main Camera，然后从Rokid SDK中拖拽RokidCamera预制体到场景，接着添加RokidInputManager到场景中即可。
（2）权限配置
关于权限配置的话，需要在Assets/Plugins/Android/AndroidManifest.xml中添加：
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />4、测试Rokid环境
配置完成后进行测试验证，需要创建测试场景，直接创建一个简单的Cube，然后添加Rokid AR相机，接着运行测试，确保没有编译错误，至此所有配置及设置就搞定啦。
彩蛋：四条"长期主义"建议
最后再给大家分享一下我自己的一些建议和心得。
1、基础设施即代码：把 Hub 安装路径、模块列表、Package 清单、CI YAML 全部 Git 化，确保新同事第一天 git pull && ./setup.sh 就能跑；
2、镜像锁哈希：对 NDK、Xcode、Module 下载地址使用 SHA256 校验，防止"上游偷换文件"导致构建幽灵失败；
3、定期灾备演练：每月抽一天故意"摧毁"构建机------清空 Jenkins、删 Runner、改 Dockerfile，验证恢复时间是否 <30 分钟；
4、文档与视频双归档：文字 Wiki 容易过时，用录屏把关键步骤拍成 3 分钟短视频，放在云盘，哪怕运维离职，新人也能按图索骥。
结束语：把环境当作"产品"来运营，而不是"一次性的脚手架"
通过上面的详细介绍，想必大家都了解了Unity从裸机到云构建的"一条龙"仪式，但需要大家请记住：环境不是静态的雕塑，而是活的生命体。做Unity相关开发的朋友应该都知道，Unity每季度一个小版本、每年一个 LTS，而Android 年年换 NDK，以及iOS 岁岁更新签名，甚至连 GitHub Actions 的 Runner 镜像也会突然弃用 Ubuntu 20.04，这说明任何一次"小透明"更新，都可能让构建脚本在深夜 3 点罢工！换句话说，环境也是"活着的产品"，需要 Roadmap、需要监控、需要灰度发布，也需要 On-Call。最后，分享一句我在某次 Global Game Jam 听到的话："工具决定下限，思维决定上限；但能让工具随时 Ready 的人，决定团队生死。"可以说："基础设施稳固，老子可以回去继续睡觉"，最最后祝大家开发顺利，愿零报错、零冲突、零崩溃常伴你左右。