1. 项目概述为什么需要离线安装Unity 2020.3 LTS如果你是一名游戏开发者或者你的团队身处网络环境受限的研发中心、保密项目组又或者你只是想为多台开发机快速部署一个稳定、统一的开发环境那么“离线安装Unity”这个需求你一定不陌生。尤其是Unity 2020.3 LTS长期支持版作为众多成熟项目和新项目立项的“定海神针”其稳定性和广泛的插件生态支持让它至今仍是许多团队的首选。然而官方默认的在线安装方式动辄几个G的下载量加上网络波动、下载失败、Hub服务器连接不畅等问题足以让一个简单的安装过程变成一场耗时半天的“拉锯战”。更棘手的是Unity Hub虽然提供了便捷的版本管理但在纯离线环境下它的“关联”和“识别”功能常常失灵。你可能遇到过明明已经把离线包拷贝到了目标机器Hub却死活找不到或者安装后Hub里显示的版本是“未激活”或“损坏”状态。这些问题背后往往是对Unity离线安装机制和Hub工作逻辑的不熟悉。今天我就结合自己多次在无网、内网环境下部署Unity 2020.3 LTS的经验为你拆解一套从资源准备、离线安装到与Hub完美关联的完整流程。我会分享官方文档里不会写的“避坑点”比如如何正确获取完整的资源包、安装脚本执行时的权限陷阱、以及让Hub“认领”离线安装版本的关键配置。无论你是为团队搭建统一的开发环境还是为自己的备用电脑做准备这篇攻略都能让你避开我踩过的那些坑高效、稳定地完成部署。2. 核心思路与准备工作理解离线安装的“两步走”策略Unity的离线安装本质上是一个“先在线后离线”的搬运过程。官方并没有提供一个可以直接下载的、完整的离线安装ISO镜像。它的核心流程分为两步理解这两步是成功的关键。2.1 官方流程解析Download Assistant的角色根据官方手册离线部署必须依赖一个叫Unity Download Assistant的工具。这个工具本身是一个很小的在线安装器它的核心作用有两个充当“采购员”和“打包员”在一台有网络的机器上它根据你的选择版本、目标平台模块等从Unity服务器下载所有必要的安装文件。生成“部署脚本”在下载文件的同时它会生成一个名为install.shmacOS/Linux或install.batWindows的脚本文件以及一个包含所有下载文件的文件夹。这个脚本就是后续在离线机器上执行安装的“钥匙”。所以整个流程可以比喻为你需要先派一个“采购员”Download Assistant去市场Unity服务器把菜安装文件买回来并写好一份“烹饪指南”安装脚本。然后你把“菜”和“指南”一起带到没有市场的厨房离线电脑按照“指南”操作就能做出同样的菜安装Unity。2.2 我们的准备工作清单在开始“采购”之前我们需要做好以下准备确保过程顺畅一台有稳定互联网连接的“在线机”系统要求Windows或macOS均可建议与你的目标“离线机”系统一致避免架构兼容问题。磁盘空间至少预留20GB以上的可用空间。Unity 2020.3 LTS编辑器本体加上常用的iOS、Android、WebGL等构建模块体积非常庞大。权限确保你有权限在“在线机”上安装软件和创建文件夹。目标“离线机”确保有足够的磁盘空间安装Unity通常需要15GB以上。如果是Windows系统务必以管理员身份运行后续的安装脚本。macOS/Linux则需要使用sudo权限。一个大容量的移动存储设备用于将“采购”好的文件包从“在线机”传输到“离线机”。一个高速的USB 3.0移动硬盘是最佳选择。明确你要安装的组件在“采购”阶段就要想好。对于Unity 2020.3 LTS我强烈建议至少包含Unity Editor编辑器本体必选。目标平台模块根据你的项目需要选择如Microsoft Visual Studio CommunityWindows平台代码编辑、Android Build Support、iOS Build Support、WebGL Build Support等。文档和示例对于离线环境本地文档非常有用但会额外增加几个G的体积请按需选择。重要提示官方流程中有一个极易出错的点。Download Assistant在下载文件时会要求你指定一个“存储离线安装文件”的位置。千万不能接受默认的临时位置或使用桌面等路径必须手动指定一个你专门创建的、路径中没有中文和特殊空格的文件夹例如D:\UnityOfflinePackages\2020.3.48f1。否则下载的文件可能不完整或者后续被系统清理掉导致离线安装失败。3. 实战第一步在“在线机”上获取离线安装包现在我们开始扮演“采购员”。这一步的目标是得到一个完整的文件夹里面包含所有安装文件和那个至关重要的安装脚本。3.1 下载并运行Unity Download Assistant访问Unity下载存档页在“在线机”的浏览器中打开Unity官方版本存档页面。你可以直接搜索“Unity download archive”找到它。找到Unity 2020.3 LTS的具体版本例如 2020.3.48f1点击其下方的“Unity Hub”下载选项旁边的下拉箭头选择Download Assistant (Win)或Download Assistant (Mac)。运行Download Assistant下载完成后运行这个安装器。在初始的欢迎和许可协议页面点击“Next”或“Agree”。选择安装组件这是关键步骤。在组件选择页面勾选你需要的所有模块。请务必仔细核对因为一旦开始下载再修改选择就需要重新下载。指定离线文件存储路径避坑关键点在安装过程中安装器会询问你是否要“下载到其他位置”或有一个“高级”选项。在Windows上通常会有一个“Download to:”的路径选择框在macOS上需要在“Select a Destination”面板选择“Advanced”然后会出现自定义路径选项。点击“Browse”或更改按钮手动导航到你事先准备好的文件夹例如D:\UnityOfflinePackages\2020.3.48f1。绝对不要使用它默认显示的路径开始下载与安装确认路径后继续流程。Download Assistant会开始下载你选择的所有组件并将其安装到“在线机”的默认程序目录如C:\Program Files\Unity\Hub\Editor\2020.3.48f1。同时它会把所有下载的原始安装包文件.pkg或.exe等以及生成的install.bat或install.sh脚本保存到你刚才指定的那个自定义文件夹中。3.2 验证离线包完整性下载完成后不要急着关闭Download Assistant。先到你指定的文件夹例如D:\UnityOfflinePackages\2020.3.48f1中检查以下内容必须存在install.bat(Windows) 或install.sh(macOS)用记事本或文本编辑器打开它你应该能看到一系列的命令主要是解压和运行各个子安装包。存在大量子安装包文件你会看到很多以组件命名的文件如UnitySetup64.exe、UnitySetup-Android-Support-for-Editor-2020.3.48f1.exe等。文件数量和你选择的组件数对应。检查文件夹大小整个文件夹的大小应该非常可观通常超过10GB。如果文件夹很小只有几MB或几百MB说明你错误地接受了默认路径下载的文件可能被放在了临时目录并且没有完整复制过来。此时需要清理文件夹重新运行Download Assistant并正确指定路径。实操心得我习惯在下载完成后将整个离线包文件夹压缩成一个.7z或.zip文件。这样做有两个好处一是便于用校验和如MD5确保文件在传输过程中未损坏二是在需要给多台离线机安装时解压一次即可避免重复拷贝大量小文件速度更快也更不容易出错。4. 实战第二步在“离线机”上执行安装将存储了离线包的移动硬盘连接到你的“离线机”并将整个文件夹拷贝到离线机的一个本地目录例如C:\UnityOfflineInstall。4.1 Windows系统安装步骤以管理员身份运行命令行在开始菜单搜索“cmd”右键点击“命令提示符”选择“以管理员身份运行”。这是确保安装脚本有权限向Program Files等系统目录写入文件的关键。导航到离线包目录在打开的命令行窗口中使用cd命令切换到你的离线包目录。cd C:\UnityOfflineInstall\2020.3.48f1执行安装脚本直接运行install.bat。install.bat等待安装完成脚本会自动按顺序调用文件夹内的各个子安装程序。整个过程是全自动的你可能会看到多个安装窗口依次弹出、运行、关闭。请耐心等待直到命令行窗口提示安装完成并自动关闭或者最后显示“Press any key to continue...”。验证安装安装完成后你可以直接到默认安装路径C:\Program Files\Unity\Hub\Editor\2020.3.48f1下查看应该存在Unity.exe等文件。但是先不要直接运行它我们下一步要解决Hub关联问题。4.2 macOS系统安装步骤打开终端通过Spotlight搜索“终端”并打开。导航到离线包目录cd /Volumes/YourExternalDrive/UnityOfflineInstall/2020.3.48f1请将路径替换为你的实际路径赋予脚本执行权限并运行chmod x install.sh sudo ./install.sh输入密码执行sudo命令后会提示你输入当前管理员账户的密码输入时屏幕无显示输完后按回车即可。等待安装完成与Windows类似脚本会自动执行。安装完成后Unity编辑器通常会出现在/Applications/Unity或/Applications/Unity/Hub/Editor/2020.3.48f1目录下。4.3 安装过程中的常见问题与排查问题运行install.bat或install.sh时报错“找不到文件”或“权限被拒绝”。排查首先确认你所在的命令行路径是否正确使用dir(Win) 或ls(macOS) 查看当前目录下是否有install脚本和大量安装包文件。其次在Windows上务必使用管理员身份的命令行在macOS上务必使用sudo。问题安装过程中某个组件安装失败。排查这通常是因为离线包不完整。请回到“在线机”上检查离线包文件夹大小并重新运行Download Assistant确保在指定存储路径时没有出错。一个完整的离线包是其成功安装的唯一保障。问题安装完成后在开始菜单或应用程序文件夹里找不到Unity快捷方式。排查这是正常现象。因为离线安装脚本可能不会创建快捷方式。我们的目标是先让Hub识别它通过Hub来启动。直接去安装目录如C:\Program Files\Unity\Hub\Editor\2020.3.48f1确认Unity.exe存在即可。5. 核心难点攻克让Unity Hub识别离线安装的版本这是整个离线安装流程中最容易卡住的一环。Unity Hub默认会扫描它自己管理的编辑器安装路径通常是C:\Program Files\Unity\Hub\Editor或/Applications/Unity/Hub/Editor。如果我们严格按照上述离线流程安装编辑器正好就安装在这个目录下理论上Hub应该能自动识别。但很多时候Hub会“装傻”。5.1 Hub自动识别失败的解决方案如果打开Hub后在“已安装”标签页没有看到你刚装好的Unity 2020.3.48f1可以尝试以下方法重启Unity Hub首先尝试完全关闭Hub包括后台进程再重新打开。有时候只是刷新问题。手动添加编辑器路径在Hub中点击左上角的“设置”齿轮图标。找到“安装位置”或类似标签。在“编辑器安装位置”下方通常会有一个“添加”或“”按钮。点击后手动浏览并选择你安装的Unity编辑器的根目录即包含Unity.exe(Win) 或Unity.app(macOS) 的文件夹例如C:\Program Files\Unity\Hub\Editor\2020.3.48f1。添加后Hub应该会扫描并识别该版本。5.2 手动编辑Hub的配置文件高级方法如果上述方法无效可能是Hub的本地数据库或配置文件没有更新。我们可以尝试手动修改。WindowsHub的配置和版本信息通常存储在%APPDATA%\UnityHub目录下。你可以尝试在关闭Hub的情况下删除或重命名这个文件夹例如改为UnityHub_backup然后重新启动Hub。Hub会重建配置文件并重新扫描所有可能的位置。注意这会重置你的Hub设置如项目列表和偏好设置。macOS配置文件通常在~/Library/Application Support/UnityHub。同样可以在关闭Hub后尝试移除或重命名。重要警告操作前请备份该文件夹。此方法有一定风险如果对系统不熟悉建议优先使用“手动添加路径”的方法。5.3 离线激活许可证即使Hub识别了编辑器在离线环境下首次启动时仍然会要求你激活许可证。你需要提前在有网的机器上完成激活然后将许可证文件拷贝到离线机。在有网机器上获取许可证文件在有网的电脑上用同一个Unity账号登录Hub并安装/激活Unity 2020.3 LTS。许可证文件的位置Windows:C:\ProgramData\Unity\(此文件夹默认隐藏需要在文件资源管理器地址栏直接输入路径或显示隐藏文件)。里面会有以Unity_lic.ulf命名的文件。macOS:~/Library/Application Support/Unity/或/Library/Application Support/Unity/。同样寻找.ulf文件。传输并放置许可证文件将找到的Unity_lic.ulf文件拷贝到离线机的相同路径下。在离线机上通过Hub启动Unity编辑器它应该会自动读取该许可证文件而不再弹出激活窗口。如果拷贝许可证后仍要求激活可以在离线机的Unity编辑器启动时选择“手动激活”然后选择“导入许可证文件”手动指向你拷贝过来的.ulf文件。6. 资源包管理与后续维护成功安装并关联后你的离线Unity环境就搭建好了。但对于团队协作或长期维护还有一些经验可以分享。6.1 创建统一的资源包归档我建议将完整的离线安装文件夹包含install.bat/sh和所有子安装包进行归档管理。为其创建一个清晰的目录结构例如Unity_Offline_Archives/ ├── 2020.3.48f1/ │ ├── Windows/ │ │ ├── install.bat │ │ ├── UnitySetup64.exe │ │ └── ... │ └── macOS/ │ ├── install.sh │ └── Unity.pkg ├── Module_Android_2020.3.48f1.zip (单独模块备份) └── README.txt (记录包含的组件、下载日期、MD5校验码)这样任何团队成员需要搭建环境时只需获取对应的版本包按照固定的步骤操作即可极大减少了沟通成本和出错概率。6.2 为离线环境添加额外模块如果后续需要在离线机上添加新的构建模块例如之前没装iOS支持现在需要了最稳妥的方法依然是回到“在线机”上使用Download Assistant仅选择你需要新增的模块并再次指定到同一个离线包存储路径。Download Assistant会只下载新增的模块包。然后将这些新增的包文件拷贝到离线机的对应目录并手动运行这些新增的.exe或.pkg安装程序。通常不需要再次运行主install.bat脚本。6.3 常见问题速查表问题现象可能原因解决方案离线安装脚本执行失败提示文件缺失1. 离线包不完整。2. 脚本执行路径不对。1. 检查离线包大小重新在在线机上下载。2. 在命令行中确认当前目录包含所有安装包。Unity Hub无法发现已安装的编辑器1. Hub未刷新。2. 编辑器未安装在Hub默认扫描路径。3. Hub配置文件异常。1. 重启Hub。2. 在Hub设置中手动添加编辑器安装路径。3. (高级)尝试重置Hub配置目录。启动Unity时要求激活无法离线许可证文件缺失或未正确放置。将有网机器上的Unity_lic.ulf文件拷贝到离线机的对应系统目录。安装过程中提示“权限不足”Windows未使用管理员命令行macOS未使用sudo。Windows以管理员身份运行CMDmacOS在命令前加sudo并输入密码。Download Assistant下载速度极慢或中断网络问题或Unity服务器问题。尝试使用网络代理或更换网络环境避开高峰时段下载。最后我想强调的是离线安装的核心在于“准备”和“验证”。在在线机上的操作务必仔细确保下载的离线包完整无误在离线机上的操作则要严格按照步骤注意权限。一旦你把整个流程跑通一次并形成规范的资源包归档后续为任何机器部署相同的开发环境都会变得轻而易举。这套方法不仅适用于2020.3 LTS也适用于其他任何你需要进行离线部署的Unity版本。