简介这是一份面向Unity初学者的详细安装教程文档围绕从零搭建Unity开发环境展开适合刚接触游戏开发、需要完成软件部署与首个项目创建的学习者参考。文档共1个docx文件压缩包约804KB内容按步骤组织涵盖Unity Hub下载与安装、账号注册、个人版许可证激活、编辑器版本及安卓等模块选择、项目模板创建、界面分区说明、中英文切换和外部脚本编辑器设置等环节。已有686人学习说明该流程对入门者具有较高参考价值。读者可据此理清安装顺序避开账号、许可证和模块勾选等常见卡点并借助对层级面板、属性面板、场景与游戏窗口、资源文件面板、控制台的介绍快速熟悉Unity编辑器的工作方式为后续脚本编写和项目实践打下基础。1. 从零到能跑Unity 安装真正要装的其实是四样东西大多数人以为 Unity 安装就是双击一个安装包、一路下一步装完却发现问题一箩筐新建项目点不动、安卓包打不出来、双击脚本毫无反应Hub 里还躺着一个“许可证过期”的红点。真正要装的其实是四样东西——Unity Hub、一个已验证的账号、一份有效的许可证、以及编辑器本体加对应模块。前三样任何一样缺失Hub 都不会放你进下一步第四样勾选不全后面调半天都是白费。这篇按实操顺序走一遍先讲 Hub、账号、许可证这三条链路怎么通再把版本和模块的勾选清单摊开说接着是新建项目和五个面板的用法最后把这条链路上最容易翻车的五个点逐条拆开。适合第一次装 Unity 的人也适合装过一两次、但每次都得重来一遍的人。2. Hub、账号与许可证三条链路缺一条都进不去2.1 Hub 装在哪编辑器和模块装在哪Unity Hub 本身只是一个启动器和版本管理器体积很小装在系统盘完全没压力。真正吃空间的是它后面要拉下来的编辑器本体以及 Android 那一整套 SDK/NDK/JDK——一个编辑器加一个安卓模块预留十几 GB 是比较稳妥的心理预期。所以装 Hub 之前先做一件事确认哪块盘还有空间然后想清楚 Hub 里的“安装路径”要指向哪里。Hub 的默认行为是把编辑器装到 Hub 的安装盘下比如 Windows 上常见的C:\Program Files\Unity\Hub\Editor。这个路径可以在 Hub 的设置里改改成一个空间充裕的盘符后面装第二个、第三个版本时就不会手忙脚乱。先看一眼磁盘# 查看各盘剩余空间决定编辑器和模块装到哪个盘 # Git Bash / WSL 里可以用 df df -h # Windows 原生命令行用 wmic新系统也可以用 PowerShell 的 Get-PSDrive wmic logicaldisk get name,freespace,sizefreespace的单位是字节除以 1024 的三次方才是 GB看着数字很大别被唬住。判断标准很简单目标盘至少留出编辑器体积的两倍余量因为安装过程中还要解压临时文件空间刚好卡在临界值时最容易出现“下载完成、校验失败、回滚”的循环。我一般会单独建一个目录比如D:\Unity\Editor让 Hub 把版本都装在这里卸载版本时直接对准目录不会跟其他软件混在一起。2.2 账号注册不登录连创建项目的按钮都是灰的Hub 装好后的第一道墙是登录。这不是可选项——没有账号就没有许可证没有许可证 Hub 不会让你新建项目编辑器启动了也会卡在激活提示上。注册入口有两个一是 Hub 界面里的登录按钮点了会拉起系统默认浏览器跳到注册页二是先在浏览器里注册完再回 Hub 登录。两条路等价区别只在于你在哪填表单。注册流程本身没什么难度容易翻车的是邮箱验证。填完信息提交后验证邮件可能进了垃圾箱也可能延迟几分钟才到。如果没点验证链接就回 Hub 登录会出现“登录成功但状态异常”的情况紧接着许可证那一步就会报错而报错文案并不会告诉你根因是邮箱没验证。血泪经验是注册完先去邮箱把链接点掉回 Hub 确认头像和用户名正常显示再往下走。登录状态会缓存在本地正常情况下不用每次重登。但如果你在同一台机器上切换过账号或者清理过系统凭据Hub 可能会要求重新验证。这时候不要反复点登录按钮硬刚先退出 Hub 进程再重新打开让它重新走一遍 OAuth 拉起流程成功率会高很多。2.3 个人版许可证免费那条路怎么点、过期怎么续登录之后是激活许可证。Hub 左侧的许可证页面里有“添加”按钮点开后会列出几个版本个人版、专业版、企业版之类。学习和小型项目用的就是个人版它是免费的条件也简单——收入规模没到那条线就用它。列表里认准标注 Personal 的那一项别被顺序绕晕界面版本不同排序会有差异。点选个人版后会弹一个协议窗口勾选同意、点确认界面会显示获取成功。到这一步许可证才算真正落到本地Hub 的项目页和编辑器才能正常工作。整个过程需要联网断网状态下点激活只会得到一个含糊的失败提示。许可证是有有效期的到期后 Hub 会明确提示过期编辑器也可能拒绝启动。续期的方式和第一次激活完全一样进许可证页面重新添加一次个人版同意协议即可。不需要卸载重装也不用清缓存。如果你经常在几台机器之间切换建议把激活这一步当成装机的固定动作装完 Hub 就先激活再谈装编辑器顺序反了的话中间会多出很多“为什么新建项目没反应”的自我怀疑。3. 编辑器版本和模块勾选一份能少折腾两小时的清单3.1 版本选择LTS 和预览版差在哪Hub 的安装列表里版本号一大串每个版本后面可能还跟着 LTS 之类的标记。LTS 是长期支持版特点是 API 稳定、补丁持续、社区资料对得上号第一次装 Unity 或者要长期维护一个项目选它最省心。不带 LTS 标记的通常是较新的技术流版本新特性先上但接口变动也更频繁拿它入门容易在查资料时对不上版本。还有一个实际问题是“要不要一次装好几个版本”。可以Hub 支持多版本并存列表里每个版本独立管理项目打开时也能指定用哪个版本。但对新手来说同时装三个版本只会让“我到底该用哪个打开”变成一个日常困惑。常见做法是先装一个 LTS等项目真的需要降级或升级时再补装补装的成本也就是下载时间。判断某个版本值不值得留看两件事项目里有没有用它创建过工程以及有没有模块绑在这个版本上。卸载编辑器不会删掉你的项目文件夹但会连带清掉该版本为项目生成的缓存目录下次用别的版本打开会重新导入一遍资源工程大的话要等挺久。3.2 模块勾选清单少勾一个后面补一次选定版本点安装后会弹出一个模块列表。这一步是整个安装流程里最容易被“一路下一步”毁掉的环节因为默认勾选只覆盖最基础的桌面开发安卓、WebGL 这些都要自己点。把常见模块摊开看模块建议作用不勾的后果Android Build Support要出安卓包就勾提供安卓打包目标平台Build Settings 里找不到 AndroidAndroid SDK NDK Tools同上建议一起勾自带 SDK/NDK免手动配环境要自己装 SDK 并设环境变量OpenJDK同上打包用的 Java 运行时Gradle 阶段报找不到 JDKVisual Studio默认勾选外部脚本编辑器双击脚本没反应或弹记事本简体中文语言包建议勾编辑器界面汉化全英文菜单查功能更慢Documentation按需离线文档只能在线查 APIWebGL Build Support按需导出网页版本没有 WebGL 平台可选这张表里最容易被忽略的是 OpenJDK。很多人勾了 Android SDK NDK Tools 就以为齐了结果打包时在 Gradle 那一步报 JDK 路径错误。三个跟安卓相关的模块是一套的要么一起勾要么就都别勾、后面自己配一套外部环境——但自己配那套的坑比勾选多得多除非你有明确的版本约束否则让 Hub 帮你装齐更划算。语言包是另一个值得单独说的。不勾中文包编辑器里所有菜单都是英文照着中文教程做的时候要在脑子里做一次翻译映射效率损失不小。中文包是独立模块勾了之后还要在偏好设置里手动切一次语言具体放在 4.4 节讲。3.3 装完补模块齿轮菜单那三个入口模块没勾全不用重装。Hub 的安装列表里每个已安装版本右侧都有一个齿轮图标点开是三项添加模块、在资源管理器中显示、卸载。这三项各管一件事别点混。“添加模块”打开的是和首次安装时一样的模块列表已经装过的会标出来你只需要补勾缺的那几个。补装只会下载对应模块的增量内容不会把整个编辑器重下一遍这点可以放心。安卓模块体积不小补装时同样是十几分钟起步所以第一次装的时候一次性勾对比事后补要省事。“在资源管理器中显示”直接跳到该版本的安装目录排查问题时很有用——比如确认某个模块目录到底存不存在或者清理残留的缓存文件夹。卸载则是对准当前版本整个移除项目文件不受影响但前面提过的缓存目录会一起没。我一般会在卸载前把项目用目标版本打开一次、确认能正常加载再动手算是一颗后悔药。顺带一个检查手段想知道机器上到底装了几个版本、各自占多少空间直接列目录比在 Hub 界面里翻更直观。# 列出 Hub 管理的编辑器安装目录确认实际装了几个版本、各自占多大 # 如果你在 Hub 设置里改过安装路径把下面的路径换成你自己的 Get-ChildItem C:\Program Files\Unity\Hub\Editor -Directory | Select-Object Name, {nSizeGB;e{ [math]::Round((Get-ChildItem $_.FullName -Recurse -File -ErrorAction SilentlyContinue | Measure-Object Length -Sum).Sum/1GB, 2) }}-Directory限定只列目录-Recurse -File递归统计文件大小Measure-Object Length -Sum求和后除以 1GB 换成人类可读的数字。跑完你会得到一张“版本号 占用空间”的清单哪个版本是空间黑洞一目了然。这一步在磁盘告急时特别有用比在 Hub 里一个个点开看要快。4. 新建项目与编辑器界面模板、路径、五个面板4.1 模板怎么选3D、2D 和 URP 的边界Hub 的项目页右上角是“新项目”旁边是“打开”——有现成工程就用打开指向工程根目录即可不要指到 Assets 里面去那是常见的选错层级。点新项目后弹出的窗口分三列左边是模板大类中间是具体模板右边是项目名和存放位置。3D 模板和 2D 模板的差别不只是“有没有第三个轴”。2D 模板默认摄像机是正交投影场景视图是平面视角Sprite 相关设置也预置好了3D 模板是透视摄像机加方向光做 2D 游戏当然也能做只是要自己把摄像机改成正交、调整视角多几步手动配置。新手按项目类型选对应模板就行别为了“通用”硬选 3D。模板列表里还有带 URP 标记的选项。URP 是可编程渲染管线带后处理、光照方案更现代但对刚接触的人来说多了一层渲染管线资产的配置材质不匹配时表现为“粉红色”排查起来很劝退。第一个项目建议先用不带管线的 Core 模板跑通流程等你要做后处理或者有明确的性能目标时再换。4.2 项目路径中文目录是个老坑但确实会疼右侧填项目名和存放路径。中文路径这条老经验至今有效打包工具链、Gradle、NDK 里的某些环节对非 ASCII 路径处理得并不好表现为打包中途报一个看不出根因的路径错误。项目名和完整路径都用英文、数字、下划线是最省心的组合。路径不要太深。工程目录里会自动生成 Library、Temp、Logs 这些子目录本来路径就长再套几层文件夹某些工具在 Windows 上很容易撞到路径长度限制。我一般用D:\Work\项目名这种两级结构干净且短。最右边还有一个是否存到云端的勾选。单机学习、本地迭代的项目不用勾勾了会把工程同步到云端协作空间多一层网络依赖断网时打开项目会卡。团队协作另说但那时候通常也不靠这个入口建工程。4.3 五个面板的职责先认门再谈用项目创建完成后会打开编辑器主界面第一次加载比较慢工程要生成一堆缓存。界面顶部是菜单栏下面一排小图标是常用操作的快捷入口鼠标悬停会有提示。真正要认的是五个面板。层级面板Hierarchy列出当前场景里所有游戏物体。新建的 3D 场景默认带一个主摄像机和一盏方向光这两个就是最小可运行场景的全部。往场景里拖任何东西这里都会多一行。属性面板Inspector显示当前选中物体的所有组件和参数。选中层级面板里的物体右边就跟着变在场景里点中物体也一样。改位置、改旋转、改灯光强度、加脚本都在这里。场景视图和游戏视图共用中间那块区域。场景视图是编辑视角可以自由移动、旋转、缩放物体游戏视图是运行时主摄像机拍到的画面编辑状态下也能预览。两个视图顶部各有自己的工具栏切换 2D/3D 显示模式的按钮在场景视图那边。资源面板Project是磁盘上 Assets 目录的映射工程里所有素材、脚本、预制体都从这里进。在这个面板里右键能创建绝大多数资源类型左边是文件夹树、右边是内容区也可以切成大图标模式看图。控制台Console默认贴在资源面板旁边显示日志、警告和报错。调试脚本时最常见的用法是打一条输出语句运行后看控制台有没有打印出来——打出来了说明代码执行到了没打出来说明根本没进那段逻辑。控制台上方有 Clear on Play 和 Error Pause 两个开关前者在每次运行前清空日志后者在有报错时暂停运行排查问题时都值得打开。4.4 语言切换和脚本编辑器绑定中文包勾了不等于界面就是中文还要手动切一次。Windows 上是“编辑 → 首选项”macOS 在应用菜单下的“首选项”里进去找“语言”或 Languages 项右侧下拉框选简体中文编辑器会提示重启生效。想切回英文就在同一个地方改回去不用重装语言包。脚本编辑器的绑定在同一个首选项窗口里找“外部工具”。右边有一个下拉框列出当前可用的脚本编辑器装了 Visual Studio 的话这里会出现对应条目选中即可。如果列表里根本没有 VS通常有两个原因一是 VS 安装时没勾 Unity 相关的工作负载二是装了但没被识别到这时候下拉框旁边的浏览按钮可以手动指定可执行文件路径。机器上装了多个版本的 VS 时下拉框里会出现多条务必选对。选错的表现是双击脚本能打开但代码补全和调试断点全都不工作因为打开的那个实例没装 Unity 工具链。绑定改完不需要重启下一次双击脚本就生效。5. 安装与配置常见问题排查五个真实翻车点5.1 现象Hub 里点安装一直转圈、卡在下载或校验现象进度条在百分之几十停住不动或者下载完成后跳到“校验失败”然后重新开始下一轮循环好几遍。原因多数是网络中断导致的包不完整校验环节发现哈希对不上就回滚。另一种情况是目标磁盘空间不足解压临时文件时写入失败但 Hub 的提示并不会明确说“空间不够”。还有少数是缓存目录里残留了上一次的半个包。解决先确认目标盘剩余空间是编辑器体积的两倍以上再检查 Hub 的下载缓存目录把没下完的临时文件清掉重来如果反复卡在同一个百分比换个时间段重试通常比连续点十次有效。别在下载过程中手动去动安装目录那会直接导致校验失败。5.2 现象新建项目后编辑器打开空白或者控制台刷 Library 相关报错现象项目创建流程走完了编辑器启动后场景视图一片灰控制台里出现一堆和 Library、Package 有关的红色报错。原因工程第一次打开要导入资源并生成 Library 缓存如果这个过程被中断——比如中途强制关掉编辑器、磁盘空间不够、或者安全软件锁住了文件——缓存就会处于残缺状态。解决关闭编辑器把工程根目录下的 Library 文件夹整个删掉重新用编辑器打开工程它会自动重建。重建时间取决于工程大小第一次慢是正常的。同时检查磁盘剩余空间空间不足时导入会在中途失败表现和上面完全一样。5.3 现象安卓模块装了打包时还是提示找不到 SDK现象Hub 里明明勾了 Android Build Support 和 SDK NDK ToolsBuild Settings 里也能切到 Android但一点打包就报 SDK 路径未设置或 JDK 找不到。原因模块是装了但编辑器偏好设置里的外部工具路径没有指过去。有些版本在安装时会自动填有些不会尤其是补装模块的情况下路径字段可能是空的。解决进首选项的外部工具页把 SDK、NDK、JDK 三个路径分别指向该版本安装目录下的对应文件夹勾选使用内嵌工具。路径填完后重启编辑器再打包。如果三个模块当初只勾了 Build Support 没勾另外两个那就得回 Hub 补装只勾一个是不够的。5.4 现象双击脚本打开的是记事本或者打开了 IDE 但不跳转到对应行现象在资源面板里双击 C# 脚本系统用文本编辑器打开了或者 VS 起来了但停在一个空窗口没有定位到文件。原因外部脚本编辑器没绑定系统就按文件关联处理.cs被记事本接走了。另一种是绑定了但 VS 的 Unity 工作负载缺失IDE 认不出工程结构所以无法跳转。解决先去首选项的外部工具把编辑器选成 Visual Studio如果列表里没有用浏览按钮手动指定。绑定完还是跳不过去就打开 VS 的安装器确认 Unity 相关工作负载已勾选并安装。还有一种情况是工程根目录里缺少解决方案文件让编辑器重新生成一次即可。5.5 现象许可证反复失效或者提示没有权限现象昨天还能用今天打开 Hub 就显示许可证过期重新激活后过一阵又变回未激活状态。原因个人版许可证本身有有效期到期就是要续这是正常行为。异常反复失效通常和账号状态有关比如邮箱没验证、登录凭据失效、或者同时登录了多个账号导致本地凭据被覆盖。解决先确认账号邮箱已验证退出 Hub 重新登录一次再进许可证页面重新添加个人版。如果机器上切换过账号把旧凭据清掉再登。激活成功后不要立刻清理系统临时文件凭据落到本地需要一点时间。6. 给环境做一次体检再留一手后悔药装完不等于装对。我习惯在新建项目后跑一次环境体检把版本号、模块状态、路径这些关键信息一次性打出来存档出问题时至少有个对照基线。写个编辑器脚本放在工程的 Editor 目录下菜单栏就会多一个入口using UnityEditor; using UnityEngine; using System.Text; public class EnvCheckWindow : EditorWindow { [MenuItem(Tools/环境体检)] public static void Open() GetWindowEnvCheckWindow(环境体检); void OnGUI() { if (GUILayout.Button(开始检查)) { var sb new StringBuilder(); // 编辑器版本和 Hub 里显示的对一下 sb.AppendLine(编辑器版本: Application.unityVersion); // 关键判断 Android 打包模块是否真的可用而不是只看 Hub 里勾没勾 bool androidOk BuildPipeline.IsBuildTargetSupported( BuildTargetGroup.Android, BuildTarget.Android); sb.AppendLine(Android 模块: (androidOk ? 可用 : 不可用)); sb.AppendLine(编辑器路径: EditorApplication.applicationPath); sb.AppendLine(工程路径: Application.dataPath); // 外部脚本编辑器的偏好项键名属于内部实现不同版本可能变化 // 这里只用来观察“有没有被设置过”不要拿它做逻辑判断 string extEditor EditorPrefs.GetString(kScriptsDefaultApp, 未设置); sb.AppendLine(脚本编辑器偏好项: extEditor); Debug.Log(sb.ToString()); } } }Application.unityVersion和 Hub 里的版本号应该完全一致不一致说明你打开工程用的不是预期版本。BuildPipeline.IsBuildTargetSupported比看 Hub 的勾选状态靠谱它检查的是当前编辑器实例能不能真的打到这个平台模块装了但路径没配好时它会返回不可用。两个路径字段用来确认工程没被放到奇怪的目录下。最后那个偏好项读取的是内部键名跨版本可能变只当参考不要写成自动化逻辑依赖它。脚本放进Assets/Editor目录编辑器编译完菜单栏就会出现 Tools 菜单。换机器、重装、升级版本之后各跑一次把输出记下来后面遇到“打包忽然不行了”这种玄学问题时至少能快速排除掉环境变量。从那以后我每次装完 Unity都会强制走一遍这套顺序先确认磁盘余量再激活许可证然后一次性勾齐模块建一个空工程跑体检最后才动业务代码。中间任何一步跳过后面都要花时间补回来。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/10/29 13:38:49 · 阅读 1.2k Unity安装配置全流程：Hub许可证、模块勾选与排错
简介这是一份面向Unity初学者的详细安装教程文档围绕从零搭建Unity开发环境展开适合刚接触游戏开发、需要完成软件部署与首个项目创建的学习者参考。文档共1个docx文件压缩包约804KB内容按步骤组织涵盖Unity Hub下载与安装、账号注册、个人版许可证激活、编辑器版本及安卓等模块选择、项目模板创建、界面分区说明、中英文切换和外部脚本编辑器设置等环节。已有686人学习说明该流程对入门者具有较高参考价值。读者可据此理清安装顺序避开账号、许可证和模块勾选等常见卡点并借助对层级面板、属性面板、场景与游戏窗口、资源文件面板、控制台的介绍快速熟悉Unity编辑器的工作方式为后续脚本编写和项目实践打下基础。1. 从零到能跑Unity 安装真正要装的其实是四样东西大多数人以为 Unity 安装就是双击一个安装包、一路下一步装完却发现问题一箩筐新建项目点不动、安卓包打不出来、双击脚本毫无反应Hub 里还躺着一个“许可证过期”的红点。真正要装的其实是四样东西——Unity Hub、一个已验证的账号、一份有效的许可证、以及编辑器本体加对应模块。前三样任何一样缺失Hub 都不会放你进下一步第四样勾选不全后面调半天都是白费。这篇按实操顺序走一遍先讲 Hub、账号、许可证这三条链路怎么通再把版本和模块的勾选清单摊开说接着是新建项目和五个面板的用法最后把这条链路上最容易翻车的五个点逐条拆开。适合第一次装 Unity 的人也适合装过一两次、但每次都得重来一遍的人。2. Hub、账号与许可证三条链路缺一条都进不去2.1 Hub 装在哪编辑器和模块装在哪Unity Hub 本身只是一个启动器和版本管理器体积很小装在系统盘完全没压力。真正吃空间的是它后面要拉下来的编辑器本体以及 Android 那一整套 SDK/NDK/JDK——一个编辑器加一个安卓模块预留十几 GB 是比较稳妥的心理预期。所以装 Hub 之前先做一件事确认哪块盘还有空间然后想清楚 Hub 里的“安装路径”要指向哪里。Hub 的默认行为是把编辑器装到 Hub 的安装盘下比如 Windows 上常见的C:\Program Files\Unity\Hub\Editor。这个路径可以在 Hub 的设置里改改成一个空间充裕的盘符后面装第二个、第三个版本时就不会手忙脚乱。先看一眼磁盘# 查看各盘剩余空间决定编辑器和模块装到哪个盘 # Git Bash / WSL 里可以用 df df -h # Windows 原生命令行用 wmic新系统也可以用 PowerShell 的 Get-PSDrive wmic logicaldisk get name,freespace,sizefreespace的单位是字节除以 1024 的三次方才是 GB看着数字很大别被唬住。判断标准很简单目标盘至少留出编辑器体积的两倍余量因为安装过程中还要解压临时文件空间刚好卡在临界值时最容易出现“下载完成、校验失败、回滚”的循环。我一般会单独建一个目录比如D:\Unity\Editor让 Hub 把版本都装在这里卸载版本时直接对准目录不会跟其他软件混在一起。2.2 账号注册不登录连创建项目的按钮都是灰的Hub 装好后的第一道墙是登录。这不是可选项——没有账号就没有许可证没有许可证 Hub 不会让你新建项目编辑器启动了也会卡在激活提示上。注册入口有两个一是 Hub 界面里的登录按钮点了会拉起系统默认浏览器跳到注册页二是先在浏览器里注册完再回 Hub 登录。两条路等价区别只在于你在哪填表单。注册流程本身没什么难度容易翻车的是邮箱验证。填完信息提交后验证邮件可能进了垃圾箱也可能延迟几分钟才到。如果没点验证链接就回 Hub 登录会出现“登录成功但状态异常”的情况紧接着许可证那一步就会报错而报错文案并不会告诉你根因是邮箱没验证。血泪经验是注册完先去邮箱把链接点掉回 Hub 确认头像和用户名正常显示再往下走。登录状态会缓存在本地正常情况下不用每次重登。但如果你在同一台机器上切换过账号或者清理过系统凭据Hub 可能会要求重新验证。这时候不要反复点登录按钮硬刚先退出 Hub 进程再重新打开让它重新走一遍 OAuth 拉起流程成功率会高很多。2.3 个人版许可证免费那条路怎么点、过期怎么续登录之后是激活许可证。Hub 左侧的许可证页面里有“添加”按钮点开后会列出几个版本个人版、专业版、企业版之类。学习和小型项目用的就是个人版它是免费的条件也简单——收入规模没到那条线就用它。列表里认准标注 Personal 的那一项别被顺序绕晕界面版本不同排序会有差异。点选个人版后会弹一个协议窗口勾选同意、点确认界面会显示获取成功。到这一步许可证才算真正落到本地Hub 的项目页和编辑器才能正常工作。整个过程需要联网断网状态下点激活只会得到一个含糊的失败提示。许可证是有有效期的到期后 Hub 会明确提示过期编辑器也可能拒绝启动。续期的方式和第一次激活完全一样进许可证页面重新添加一次个人版同意协议即可。不需要卸载重装也不用清缓存。如果你经常在几台机器之间切换建议把激活这一步当成装机的固定动作装完 Hub 就先激活再谈装编辑器顺序反了的话中间会多出很多“为什么新建项目没反应”的自我怀疑。3. 编辑器版本和模块勾选一份能少折腾两小时的清单3.1 版本选择LTS 和预览版差在哪Hub 的安装列表里版本号一大串每个版本后面可能还跟着 LTS 之类的标记。LTS 是长期支持版特点是 API 稳定、补丁持续、社区资料对得上号第一次装 Unity 或者要长期维护一个项目选它最省心。不带 LTS 标记的通常是较新的技术流版本新特性先上但接口变动也更频繁拿它入门容易在查资料时对不上版本。还有一个实际问题是“要不要一次装好几个版本”。可以Hub 支持多版本并存列表里每个版本独立管理项目打开时也能指定用哪个版本。但对新手来说同时装三个版本只会让“我到底该用哪个打开”变成一个日常困惑。常见做法是先装一个 LTS等项目真的需要降级或升级时再补装补装的成本也就是下载时间。判断某个版本值不值得留看两件事项目里有没有用它创建过工程以及有没有模块绑在这个版本上。卸载编辑器不会删掉你的项目文件夹但会连带清掉该版本为项目生成的缓存目录下次用别的版本打开会重新导入一遍资源工程大的话要等挺久。3.2 模块勾选清单少勾一个后面补一次选定版本点安装后会弹出一个模块列表。这一步是整个安装流程里最容易被“一路下一步”毁掉的环节因为默认勾选只覆盖最基础的桌面开发安卓、WebGL 这些都要自己点。把常见模块摊开看模块建议作用不勾的后果Android Build Support要出安卓包就勾提供安卓打包目标平台Build Settings 里找不到 AndroidAndroid SDK NDK Tools同上建议一起勾自带 SDK/NDK免手动配环境要自己装 SDK 并设环境变量OpenJDK同上打包用的 Java 运行时Gradle 阶段报找不到 JDKVisual Studio默认勾选外部脚本编辑器双击脚本没反应或弹记事本简体中文语言包建议勾编辑器界面汉化全英文菜单查功能更慢Documentation按需离线文档只能在线查 APIWebGL Build Support按需导出网页版本没有 WebGL 平台可选这张表里最容易被忽略的是 OpenJDK。很多人勾了 Android SDK NDK Tools 就以为齐了结果打包时在 Gradle 那一步报 JDK 路径错误。三个跟安卓相关的模块是一套的要么一起勾要么就都别勾、后面自己配一套外部环境——但自己配那套的坑比勾选多得多除非你有明确的版本约束否则让 Hub 帮你装齐更划算。语言包是另一个值得单独说的。不勾中文包编辑器里所有菜单都是英文照着中文教程做的时候要在脑子里做一次翻译映射效率损失不小。中文包是独立模块勾了之后还要在偏好设置里手动切一次语言具体放在 4.4 节讲。3.3 装完补模块齿轮菜单那三个入口模块没勾全不用重装。Hub 的安装列表里每个已安装版本右侧都有一个齿轮图标点开是三项添加模块、在资源管理器中显示、卸载。这三项各管一件事别点混。“添加模块”打开的是和首次安装时一样的模块列表已经装过的会标出来你只需要补勾缺的那几个。补装只会下载对应模块的增量内容不会把整个编辑器重下一遍这点可以放心。安卓模块体积不小补装时同样是十几分钟起步所以第一次装的时候一次性勾对比事后补要省事。“在资源管理器中显示”直接跳到该版本的安装目录排查问题时很有用——比如确认某个模块目录到底存不存在或者清理残留的缓存文件夹。卸载则是对准当前版本整个移除项目文件不受影响但前面提过的缓存目录会一起没。我一般会在卸载前把项目用目标版本打开一次、确认能正常加载再动手算是一颗后悔药。顺带一个检查手段想知道机器上到底装了几个版本、各自占多少空间直接列目录比在 Hub 界面里翻更直观。# 列出 Hub 管理的编辑器安装目录确认实际装了几个版本、各自占多大 # 如果你在 Hub 设置里改过安装路径把下面的路径换成你自己的 Get-ChildItem C:\Program Files\Unity\Hub\Editor -Directory | Select-Object Name, {nSizeGB;e{ [math]::Round((Get-ChildItem $_.FullName -Recurse -File -ErrorAction SilentlyContinue | Measure-Object Length -Sum).Sum/1GB, 2) }}-Directory限定只列目录-Recurse -File递归统计文件大小Measure-Object Length -Sum求和后除以 1GB 换成人类可读的数字。跑完你会得到一张“版本号 占用空间”的清单哪个版本是空间黑洞一目了然。这一步在磁盘告急时特别有用比在 Hub 里一个个点开看要快。4. 新建项目与编辑器界面模板、路径、五个面板4.1 模板怎么选3D、2D 和 URP 的边界Hub 的项目页右上角是“新项目”旁边是“打开”——有现成工程就用打开指向工程根目录即可不要指到 Assets 里面去那是常见的选错层级。点新项目后弹出的窗口分三列左边是模板大类中间是具体模板右边是项目名和存放位置。3D 模板和 2D 模板的差别不只是“有没有第三个轴”。2D 模板默认摄像机是正交投影场景视图是平面视角Sprite 相关设置也预置好了3D 模板是透视摄像机加方向光做 2D 游戏当然也能做只是要自己把摄像机改成正交、调整视角多几步手动配置。新手按项目类型选对应模板就行别为了“通用”硬选 3D。模板列表里还有带 URP 标记的选项。URP 是可编程渲染管线带后处理、光照方案更现代但对刚接触的人来说多了一层渲染管线资产的配置材质不匹配时表现为“粉红色”排查起来很劝退。第一个项目建议先用不带管线的 Core 模板跑通流程等你要做后处理或者有明确的性能目标时再换。4.2 项目路径中文目录是个老坑但确实会疼右侧填项目名和存放路径。中文路径这条老经验至今有效打包工具链、Gradle、NDK 里的某些环节对非 ASCII 路径处理得并不好表现为打包中途报一个看不出根因的路径错误。项目名和完整路径都用英文、数字、下划线是最省心的组合。路径不要太深。工程目录里会自动生成 Library、Temp、Logs 这些子目录本来路径就长再套几层文件夹某些工具在 Windows 上很容易撞到路径长度限制。我一般用D:\Work\项目名这种两级结构干净且短。最右边还有一个是否存到云端的勾选。单机学习、本地迭代的项目不用勾勾了会把工程同步到云端协作空间多一层网络依赖断网时打开项目会卡。团队协作另说但那时候通常也不靠这个入口建工程。4.3 五个面板的职责先认门再谈用项目创建完成后会打开编辑器主界面第一次加载比较慢工程要生成一堆缓存。界面顶部是菜单栏下面一排小图标是常用操作的快捷入口鼠标悬停会有提示。真正要认的是五个面板。层级面板Hierarchy列出当前场景里所有游戏物体。新建的 3D 场景默认带一个主摄像机和一盏方向光这两个就是最小可运行场景的全部。往场景里拖任何东西这里都会多一行。属性面板Inspector显示当前选中物体的所有组件和参数。选中层级面板里的物体右边就跟着变在场景里点中物体也一样。改位置、改旋转、改灯光强度、加脚本都在这里。场景视图和游戏视图共用中间那块区域。场景视图是编辑视角可以自由移动、旋转、缩放物体游戏视图是运行时主摄像机拍到的画面编辑状态下也能预览。两个视图顶部各有自己的工具栏切换 2D/3D 显示模式的按钮在场景视图那边。资源面板Project是磁盘上 Assets 目录的映射工程里所有素材、脚本、预制体都从这里进。在这个面板里右键能创建绝大多数资源类型左边是文件夹树、右边是内容区也可以切成大图标模式看图。控制台Console默认贴在资源面板旁边显示日志、警告和报错。调试脚本时最常见的用法是打一条输出语句运行后看控制台有没有打印出来——打出来了说明代码执行到了没打出来说明根本没进那段逻辑。控制台上方有 Clear on Play 和 Error Pause 两个开关前者在每次运行前清空日志后者在有报错时暂停运行排查问题时都值得打开。4.4 语言切换和脚本编辑器绑定中文包勾了不等于界面就是中文还要手动切一次。Windows 上是“编辑 → 首选项”macOS 在应用菜单下的“首选项”里进去找“语言”或 Languages 项右侧下拉框选简体中文编辑器会提示重启生效。想切回英文就在同一个地方改回去不用重装语言包。脚本编辑器的绑定在同一个首选项窗口里找“外部工具”。右边有一个下拉框列出当前可用的脚本编辑器装了 Visual Studio 的话这里会出现对应条目选中即可。如果列表里根本没有 VS通常有两个原因一是 VS 安装时没勾 Unity 相关的工作负载二是装了但没被识别到这时候下拉框旁边的浏览按钮可以手动指定可执行文件路径。机器上装了多个版本的 VS 时下拉框里会出现多条务必选对。选错的表现是双击脚本能打开但代码补全和调试断点全都不工作因为打开的那个实例没装 Unity 工具链。绑定改完不需要重启下一次双击脚本就生效。5. 安装与配置常见问题排查五个真实翻车点5.1 现象Hub 里点安装一直转圈、卡在下载或校验现象进度条在百分之几十停住不动或者下载完成后跳到“校验失败”然后重新开始下一轮循环好几遍。原因多数是网络中断导致的包不完整校验环节发现哈希对不上就回滚。另一种情况是目标磁盘空间不足解压临时文件时写入失败但 Hub 的提示并不会明确说“空间不够”。还有少数是缓存目录里残留了上一次的半个包。解决先确认目标盘剩余空间是编辑器体积的两倍以上再检查 Hub 的下载缓存目录把没下完的临时文件清掉重来如果反复卡在同一个百分比换个时间段重试通常比连续点十次有效。别在下载过程中手动去动安装目录那会直接导致校验失败。5.2 现象新建项目后编辑器打开空白或者控制台刷 Library 相关报错现象项目创建流程走完了编辑器启动后场景视图一片灰控制台里出现一堆和 Library、Package 有关的红色报错。原因工程第一次打开要导入资源并生成 Library 缓存如果这个过程被中断——比如中途强制关掉编辑器、磁盘空间不够、或者安全软件锁住了文件——缓存就会处于残缺状态。解决关闭编辑器把工程根目录下的 Library 文件夹整个删掉重新用编辑器打开工程它会自动重建。重建时间取决于工程大小第一次慢是正常的。同时检查磁盘剩余空间空间不足时导入会在中途失败表现和上面完全一样。5.3 现象安卓模块装了打包时还是提示找不到 SDK现象Hub 里明明勾了 Android Build Support 和 SDK NDK ToolsBuild Settings 里也能切到 Android但一点打包就报 SDK 路径未设置或 JDK 找不到。原因模块是装了但编辑器偏好设置里的外部工具路径没有指过去。有些版本在安装时会自动填有些不会尤其是补装模块的情况下路径字段可能是空的。解决进首选项的外部工具页把 SDK、NDK、JDK 三个路径分别指向该版本安装目录下的对应文件夹勾选使用内嵌工具。路径填完后重启编辑器再打包。如果三个模块当初只勾了 Build Support 没勾另外两个那就得回 Hub 补装只勾一个是不够的。5.4 现象双击脚本打开的是记事本或者打开了 IDE 但不跳转到对应行现象在资源面板里双击 C# 脚本系统用文本编辑器打开了或者 VS 起来了但停在一个空窗口没有定位到文件。原因外部脚本编辑器没绑定系统就按文件关联处理.cs被记事本接走了。另一种是绑定了但 VS 的 Unity 工作负载缺失IDE 认不出工程结构所以无法跳转。解决先去首选项的外部工具把编辑器选成 Visual Studio如果列表里没有用浏览按钮手动指定。绑定完还是跳不过去就打开 VS 的安装器确认 Unity 相关工作负载已勾选并安装。还有一种情况是工程根目录里缺少解决方案文件让编辑器重新生成一次即可。5.5 现象许可证反复失效或者提示没有权限现象昨天还能用今天打开 Hub 就显示许可证过期重新激活后过一阵又变回未激活状态。原因个人版许可证本身有有效期到期就是要续这是正常行为。异常反复失效通常和账号状态有关比如邮箱没验证、登录凭据失效、或者同时登录了多个账号导致本地凭据被覆盖。解决先确认账号邮箱已验证退出 Hub 重新登录一次再进许可证页面重新添加个人版。如果机器上切换过账号把旧凭据清掉再登。激活成功后不要立刻清理系统临时文件凭据落到本地需要一点时间。6. 给环境做一次体检再留一手后悔药装完不等于装对。我习惯在新建项目后跑一次环境体检把版本号、模块状态、路径这些关键信息一次性打出来存档出问题时至少有个对照基线。写个编辑器脚本放在工程的 Editor 目录下菜单栏就会多一个入口using UnityEditor; using UnityEngine; using System.Text; public class EnvCheckWindow : EditorWindow { [MenuItem(Tools/环境体检)] public static void Open() GetWindowEnvCheckWindow(环境体检); void OnGUI() { if (GUILayout.Button(开始检查)) { var sb new StringBuilder(); // 编辑器版本和 Hub 里显示的对一下 sb.AppendLine(编辑器版本: Application.unityVersion); // 关键判断 Android 打包模块是否真的可用而不是只看 Hub 里勾没勾 bool androidOk BuildPipeline.IsBuildTargetSupported( BuildTargetGroup.Android, BuildTarget.Android); sb.AppendLine(Android 模块: (androidOk ? 可用 : 不可用)); sb.AppendLine(编辑器路径: EditorApplication.applicationPath); sb.AppendLine(工程路径: Application.dataPath); // 外部脚本编辑器的偏好项键名属于内部实现不同版本可能变化 // 这里只用来观察“有没有被设置过”不要拿它做逻辑判断 string extEditor EditorPrefs.GetString(kScriptsDefaultApp, 未设置); sb.AppendLine(脚本编辑器偏好项: extEditor); Debug.Log(sb.ToString()); } } }Application.unityVersion和 Hub 里的版本号应该完全一致不一致说明你打开工程用的不是预期版本。BuildPipeline.IsBuildTargetSupported比看 Hub 的勾选状态靠谱它检查的是当前编辑器实例能不能真的打到这个平台模块装了但路径没配好时它会返回不可用。两个路径字段用来确认工程没被放到奇怪的目录下。最后那个偏好项读取的是内部键名跨版本可能变只当参考不要写成自动化逻辑依赖它。脚本放进Assets/Editor目录编辑器编译完菜单栏就会出现 Tools 菜单。换机器、重装、升级版本之后各跑一次把输出记下来后面遇到“打包忽然不行了”这种玄学问题时至少能快速排除掉环境变量。从那以后我每次装完 Unity都会强制走一遍这套顺序先确认磁盘余量再激活许可证然后一次性勾齐模块建一个空工程跑体检最后才动业务代码。中间任何一步跳过后面都要花时间补回来。希望帮到你。本文还有配套的精品资源点击获取