简介:这是一份面向Unity初学者的详细安装教程,以docx文档形式完整梳理从零开始部署Unity开发环境的全过程。内容围绕Unity Hub下载安装、账号注册、个人版许可证激活、编辑器版本与组件选择、新项目创建、界面布局以及语言切换等高频环节展开,特别对安卓模块勾选、中文路径注意事项、脚本编辑器设置等易踩坑细节给出了明确说明,能帮助读者避开常见问题,顺利完成从安装到新建项目的首套流程。教程共1个docx文件,整体包体仅804KB,Word格式便于本地阅读、检索与打印对照。目前已有683人学习该教程,适合刚接触Unity、希望快速搭建开发环境并了解基础面板操作的零基础学习者。相比零散的网络问答,这份文档将关键步骤按顺序归纳,相当于一份可直接跟随操作的装机速查手册。
1. 装 Unity 前先看清流程:不是单个安装包,是四件套组合
Unity 的安装教程在网络上一搜一大把,但多数人照着点完还是会翻车:要么许可证弹窗反复出现,要么项目创建后黑屏半天,要么安卓打包时提示缺模块。Unity 的安装从来不是一个安装包的事,而是 Hub、编辑器、许可证、组件模块四件套组合流程。这篇笔记把这套流程从下载到跑通第一个场景完整拆开,适合刚接触 Unity 的新手,也适合被许可证和模块问题折腾过的老手。先给结论:先装 Hub,再登录账号激活个人版免费许可证,然后用 Hub 装编辑器本体,组件一次选够,路径不带中文,最后创建一个空场景验证。顺序走对,后面能省很多事。
2. Unity Hub 与许可证:把个人版免费激活这条链路走通
2.1 为什么第一步是装 Hub,而不是直接下编辑器
我第一次装 Unity 时也走过弯路:直接去下载编辑器安装包,装完发现没有项目管理入口,想加一个安卓模块不知道去哪里找,想换版本只能卸载重装,非常被动。后来才明白,Unity 官方把下载、管理、授权集中到了 Hub 这一个入口里。Hub 相当于一个总控台,编辑器本体反而是它管理的对象。
两者最大的差别在“改错成本”上:直接安装编辑器,后续的版本切换、模块补充、许可证过期处理全得手动;走 Hub 流程,这些操作都只是点按钮的事。所以下载页面给的是 Hub 安装包,而不是编辑器本体安装包,这一步的顺序不能反。
下表总结两种方式的实际差异:
| 对比项 | 直接安装编辑器 | 先装 Hub 再装编辑器 |
|---|---|---|
| 多版本并存 | 需要手动管理,易冲突 | Hub 里一键切换 |
| 补装模块 | 找不到入口 | 齿轮菜单添加即可 |
| 许可证管理 | 独立激活,容易漏 | 集中统一管理 |
| 项目模板入口 | 需要另找 | Hub 内直接新建 |
下载 Hub 时认准官方站点的下载页,Windows、macOS、Linux 三个平台的安装包都有,选自己系统的就行。Windows 下双击安装包,安装路径用默认的,一路下一步即可。这里我一般不建议改 Hub 本体的安装位置:它很小,主要配置写在了用户目录,改到 D 盘反而可能带来权限上的小麻烦。
Hub 安装完成后首次启动,界面主要是三个大块:项目、安装、学习。项目页管理已创建的工程,安装页管理编辑器版本和模块,学习页是一些官方教程入口。第一次进来可以先只盯着“安装”页,别急着点学习里的东西。
首次打开 Hub,会看到右上角有一个登录入口。点击之后浏览器会弹到网页,完成账号注册和登录,Hub 这边自动同步。注册邮箱建议用一个能长期收信的邮箱,后面许可证、账号找回都靠它。有同学反馈说“点了登录没反应”,大概率是浏览器拦截了跳转,把弹窗放行一次就好了。
2.2 个人版许可证激活:免费,但最容易漏
登录完成不等于可以开始用。很多人第一次在这卡住:去新建项目,提示没有许可证;或者好不容易建了项目,编辑器里一直弹授权提醒。原因就一个:还没有激活许可证。
在 Hub 里找到许可证入口,点“添加许可证”,列表里会出现几个类型,个人版(Personal)排在上方,是免费的那个。选中后阅读并同意协议,等待授权写回,许可证列表里出现一条记录,激活才算完成。这个过程通常几十秒,不需要填卡号之类的东西。
这里有三个细节值得说清楚。第一,个人版是免费学习版,适合非公司环境的个人学习和实验;如果你的用途是商业项目或公司环境,收费规则另算,别混着选。第二,许可证和登录账号绑定,账号一换、机器一换,都要重新激活,这不是系统出 bug。第三,激活成功并不需要手动下载任何许可证文件,Hub 会把授权信息写进本地配置,放心重启。
常见误用是把“登录”当成“激活”:登录只是让 Hub 认识你,激活才是给编辑器发授权。两者都做了,项目创建才会一切顺利。如果你之前误选了别的许可证类型,处理也不难:回到许可证页面,把不需要的记录移除,重新添加个人版。
如果点击同意后一直转圈没有结果,先检查网络是否稳定,再重新登录一次。个别系统把授权写进用户配置时会被安全软件拦截,弹窗放行后再试一次。激活不是一次性的事,它记录在账号下,所以下次登录同一账号,历史许可证还能看到。
提示:激活时机选择在安装编辑器之前,而不是之后。先激活许可,再让编辑器下载安装,首次启动就能直接进入可用状态,减少一个变量。
2.3 许可证过期、多许可证切换与清理
个人版许可证是有期限的,到期前 Hub 界面会提示,项目启动时也可能弹窗。看到“许可证过期”先别慌,这不是账号被封。处理流程是:确认 Hub 右上角已登录,进入许可证页面,点“添加”重新走一遍个人版激活,通常几十秒就恢复,之前创建的项目都在,不受影响。
有时候一个账号下会出现多条许可证记录,比如之前试过付费版试用,后来又激活了个人版。这时候要注意当前生效的是哪一条:过期记录会干扰判断,明明个人版已经激活,系统却读到了旧的过期记录,弹窗照出。我一般会把不需要的记录先移除,只保留当前一个有效的,再重启 Hub 一次。
还有一种情况是个人版许可证明明激活了,新建项目时仍提示无权限,这多半是编辑器启动时没有读到授权信息。解决方式是完全退出 Hub 和编辑器,在 Hub 里重新点一次项目里的“打开”按钮,让 Hub 把授权刷新后再拉起编辑器。
如果是在公司电脑和个人电脑之间切换,同一个账号也可以反复激活,但要注意个人版的使用边界,别把个人免费授权用到付费场景里。许可证问题排查的顺序就三步:一查登录状态,二看生效记录,三重新激活。按这个顺序走,百分之八九十的弹窗都能解决在这三步之内。
3. 安装编辑器本体:版本、组件与后续模块的取舍
3.1 版本怎么选:LTS、正式版、预览版与磁盘空间
Hub 的安装栏里有一个“安装编辑器”按钮,点开是一份版本列表。常见的有 LTS(长期支持版)、最新正式版和预览版(Preview)。对绝大多数项目,LTS 是最稳的选择:修 bug 和补丁的周期长,插件生态也跟得紧;预览版适合尝鲜新功能,但管线变化大,临时项目用用可以,正式项目别一上来就上预览版。
版本列表里每个版本都会标出是否为 LTS 或正式版,装过的版本会显示“已安装”。选版本时除了看数字,还要注意右侧的日期和平台支持情况,有些旧版本在新系统上打开会提示兼容问题。如果机器上已经有一个旧版本且项目较多,先别急着装新版,新版本打开旧项目后,资源导入和管线更新可能让项目一时半会不稳定。我一般会新建项目试新版,确认没问题后再考虑迁旧项目。
我个人常用的选择逻辑:学习阶段装一个当前主流的 LTS 版本,把精力花在功能上而不是版本差异上;如果项目发布平台明确是某一渠道,该渠道要求的版本优先。硬盘空间按一个编辑器 10~20 GB 估算,多装两个版本就是几十 GB,装之前先看一眼剩余空间。
Windows 下可以用 PowerShell 快速确认某个盘的空间:
Get-PSDrive C | Select-Object Used,Free这里的 Get-PSDrive 是列出驱动器信息,C 表示 C 盘,Select-Object 只挑选 Used(已用)和 Free(剩余)两列。如果 Free 的值很小,先把磁盘清理一下再装。Ubuntu 桌面版的话用 df -h 也能看,思路一样:剩余空间小于 20 GB 时不建议继续装新版本。
版本安装路径默认在 C 盘用户目录附近,空间紧张时可以在安装前把位置改成 D 盘或数据盘。Hub 会记住每个版本安装的位置,卸载时也按记录来。多个版本并存没有冲突,创建项目时右上角可以随时切换使用哪个版本。
3.2 组件勾选:安卓、VS 与中文语言包
选好版本点安装,会弹出一个“添加组件”的列表。这一步很多人直接全部默认,结果后续要用哪个功能再回来补装,多花一次下载时间。组件分几类,常见的有:文档组件、英文语言包之外的中文语言包、Android Build Support(安卓构建支持)、WebGL 支持,以及默认的代码编辑器支持。
组件优先级上,我的建议是先勾必选项,再勾可能会用到的项。必选项包括编辑器本体、VS、文档;可能用到的是 Android、WebGL、语言包。全部勾选也不是不行,只是下载体积和安装时长会明显增加,第一次装没必要背满全包。
如果你可能要出安卓包,Android Build Support 这一项要勾上,里面通常还包含 SDK 与 NDK 相关组件,体积比较大。不勾的话,以后从 Unity 里 Build 到 Android 会直接提示找不到 SDK 或构建模块,那时候再补装模块,还得重新下一遍同样的包,时间没省。WebGL 同理,做网页版再勾。
组件列表里还有语言包,需要中文界面的把中文语言包选上,这样装完就能在偏好设置里切中文,不用事后对着英文菜单猜。不过语言包只会翻译编辑器的界面文案,脚本里报错日志依然是英文,这个要有心理准备。
VS 是 Unity 默认绑定的代码编辑器选项,安装组件时勾上,装完新建脚本后双击会被关联到 VS,代码高亮和补全开箱即用。如果你已经有 VS 或想用其他编辑器,可以在安装时去掉这一项,等装完再在外部工具里指定。组件是否勾全,直接决定了后面是顺畅还是反复补车票。
3.3 装完再想改:齿轮菜单里的添加模块、显示目录与卸载
安装完成之后,还会遇到“当时没勾现在想要”的情况,不用重装整个编辑器。在 Hub 的安装列表里,点版本条目右侧的齿轮,会出现下拉菜单:添加模块、在资源管理器中显示、卸载。
“添加模块”就是重新打开组件列表,把上次没勾的补上,勾选后点安装,只下载新增部分。“在资源管理器中显示”会打开该版本在本地的安装文件夹,查日志、看配置、手动清理临时目录都在这里。“卸载”则是把整个编辑器版本从磁盘上删掉,注意卸载不会删除你创建的项目,项目文件都在各自的工程目录里,只是编辑器版本没了。
另外一个容易忽略的点:卸载版本时,如果有项目正在用这个版本,先关闭项目再卸,否则项目文件里的临时锁可能会被留下,下次打开要手动清理。在资源管理器中显示,也可以用来确认安装目录是否残留了大体积的临时缓存,看情况手动删除 Temp 相关目录。
我把齿轮菜单看成每一版编辑器的控制面板:日常加模块、定位文件、做版本清理都从这进。卸载过时版本时,顺手把对应版本的许可证记录也清理一下,保持列表干净。多版本并存的情况下,每次用哪个版本创建项目,就在 Hub 项目页右上角先切换清楚,建完发现用错版本,也可以在编辑器的首选项里改。
4. 从新建项目到界面认门:第二十分钟内跑通第一个场景
4.1 新项目向导的三列:模板、项目名和路径的讲究
编辑器装好、许可证激活后,回到 Hub 的“项目”栏,点右上角“新项目”,弹出的是三列布局。左列是模板大类,中列是具体模板,右列是项目配置。模板大类常见的有 3D、2D、URP、高清渲染管线等。3D 和 2D 的区别参考的是场景轴向:2D 模板会预设正交相机和适合 2D 的默认设置;3D 模板有透视相机。想做 2D 游戏但选了 3D 模板,只要忽略第三轴向照样可以做,只是相机和光照默认是按 3D 预设的,需要自己调整。
模板这列的默认项会随着 Hub 版本更新而变化,旧教程里只有 3D 和 2D,新版本可能多了 URP、HDRP 等模板。URP 偏向移动端和性能,HDRP 偏向高清渲染,学习阶段先用默认的 3D 模板即可。如果你在建项目时没找到某个模板,多半是版本没装对应的渲染管线包,在包管理器里补。
右列最上方是项目名称,下方是保存位置,还有一个“是否存储到云端”的勾选项。项目名尽量用英文或拼音,路径里不要出现中文。原因比较实在:Unity 的内部资源导入和编译流程对路径里的中文或特殊字符敏感,中文路径到了出包阶段容易出现手机上找不到文件、字体乱码之类的问题。这不是玄学,是很多人用血泪换来的教训。
云端存储适合需要多设备同步的场景,暂时不需要就不要勾。点“创建项目”后,编辑器会启动并导入默认资源包,首次创建往往要等一两分钟,界面看起来像卡住。判断是真卡还是正在加载,可以看屏幕底部有没有进度条,或者任务管理器里 Unity 进程的 CPU 占用是否活跃。
4.2 五个核心面板:层级、属性、场景/游戏、资源与控制台
项目创建完成后,首次打开的编辑器界面信息量很大。完全看懂只花十分钟,我来说最常见的五个面板。
| 面板 | 作用 | 高频操作 |
|---|---|---|
| 层级面板 | 显示场景中所有游戏物体 | 选中、拖入、删除物体 |
| 属性面板 | 显示选中物体的参数 | 修改位置、旋转、缩放 |
| 场景/游戏窗口 | 编辑与预览画面 | 移动视图、播放测试 |
| 资源文件面板 | 映射本地项目文件夹 | 导入资源、右键创建 |
| 控制台 | 输出日志与报错 | 查看运行时信息 |
层级面板在最左侧,场景里默认有摄像机和一个平行光,把它们理解成第一人称的视角和照明来源就行。拖进场景的模型、空物体和挂载脚本的节点,都会出现在层级面板里。选中任何一个层级项,右侧属性面板就会显示它的 Transform、组件和脚本参数。场景窗口用于编辑摆放,游戏窗口则模拟运行时摄像机看到的效果。
资源文件面板其实是把本地的项目文件夹映射成了可视列表,左侧文件夹树,右侧大图标预览。在这里面右键可以创建文件夹、脚本、材质、预制体等资源。层级面板和资源面板的区别要分清:层级里是场景中实际存在的物体,资源里是可以反复使用的素材。拖一个资源到层级,就会在场景里实例化它。
控制台是排查问题的第一站:点击菜单栏里“窗口”下方的控制台入口,或者直接看编辑器下方。脚本里打一句输出,运行后能在控制台看到,就说明脚本被挂上了并且执行到了这一行。试一下:
using UnityEngine; public class HelloUnity : MonoBehaviour { void Start() { Debug.Log("Hello Unity, 场景已正常启动"); } }这段代码里,using UnityEngine 引入命名空间,MonoBehaviour 让类可以作为组件挂到物体上,Start 方法会在场景运行的第一帧前执行一次,Debug.Log 把字符串打到控制台。如果你发现运行后控制台没有输出,先去层级面板看脚本是否挂在某个物体上;如果挂上了还没输出,再看代码里有没有编译错误的红字。
4.3 中英文切换与脚本编辑器设置的位置
界面语言切换藏在菜单栏的“编辑”里。点编辑,选最下面的“首选项”,弹出的窗口里找“语言/Languages”,把下拉从英文切到“简体中文”,重启编辑器就能生效。如果安装时没勾中文语言包,这一步只有 English 可选项,先回 Hub 齿轮菜单里“添加模块”,补装中文包再切换。
脚本编辑器的设置位置在同一个首选项窗口里,左边选“外部工具”,右边会列出系统里检测到的代码编辑器,默认是 VS。选好后新建的脚本双击就会用指定编辑器打开。常见问题是系统里装了多个版本的 VS,Unity 可能默认绑定到旧版,代码补全和工程识别都不对,解决办法就是在外部工具下拉里明确指定你日常用的那个版本。
如果你不想用 VS,想用其他编辑器,在外部工具下拉里也能选到系统识别到的编辑器。换成其他编辑器后,代码提示是否完整取决于编辑器本身和 Unity 集成的插件情况。VS 是默认选项,用它最省事;新手不建议在起步阶段花太多时间折腾编辑器,功能写起来才是重点。
切换完语言和编辑器,建议立刻重开一次项目测试,确认没有菜单错乱或脚本关联失效,再继续正常创作。首选项的设置是全局的,作用于当前版本编辑器,所有项目共享,所以只需设置一次。
5. Unity 安装与初始化避坑:五条踩坑记录与排查顺序
这一章把我在装机过程中反复遇到的五个问题整理出来,每条按“现象 → 原因 → 解决”的顺序写,方便你遇到时快速对照。
5.1 许可证反复弹出过期,重新登录也没用
现象:Hub 顶部一直提示许可证过期,进入项目时弹窗要求激活,重新登录账号后仍然出现。
原因:最常见的是个人版许可证确实到了有效期,或者账号下有多条旧记录,系统读到了过期那一条;另一个容易被忽略的原因是系统时间不对,时间偏差过大会导致授权校验失败。
解决:先检查系统时间和时区是否自动同步;确认 Hub 已登录当前账号;进入许可证页面把过期记录移除,重新添加个人版;最后重启 Hub 和编辑器。按这个顺序做完,绝大多数重复弹窗都会消失。
5.2 安装进度卡住,长时间不前进
现象:编辑器或模块下载到某个百分比后一动不动,重启 Hub 也一样。
原因:网络波动导致下载连接被中断,或安全软件的实时监控把下载进程拦截,再就是磁盘空间不足导致临时文件写不进去。
解决:暂停后继续或换一个网络环境重试;把下载目录的杀毒软件实时防护暂时关掉,装完再开;用 PowerShell 检查剩余空间,低于 5 GB 先清理。注意这里是下载问题,不是安装问题,卡的位置通常在进度条前段。
5.3 创建项目后长时间黑屏,CPU 却很高
现象:新项目创建后编辑器窗口长时间黑屏,鼠标转圈,任务管理器里 Unity 进程占满 CPU。
原因:首次创建项目要导入默认资源、生成着色器缓存和编译脚本,这个过程在配置普通的机器上可能持续几分钟,看起来很像是死机;显卡驱动过旧或项目路径含中文也会导致界面渲染卡住。
解决:先耐心等待 5-10 分钟,观察任务管理器里进程是否在波动;如果长时间纹丝不动,强制结束进程,把项目路径改成纯英文再重建;更新显卡驱动后重启电脑,再打开原有项目。
5.4 中文语言包装了,界面还是英文或菜单错乱
现象:勾选并安装了中文语言包,首选项里也切换到中文,重启后界面还是英文,或者部分菜单文字错乱。
原因:语言包和编辑器版本不匹配,或者切换后没有完全退出再重启;在项目运行时切换语言也容易出现菜单没刷新的情况。
解决:先关掉所有打开的工程,完全退出编辑器,在首选项里把语言切到中文,保存并重启。如果仍然英文,回到 Hub 齿轮菜单把语言模块卸载,重新添加后再切换。
5.5 新建脚本双击打开的是记事本,没有任何代码提示
现象:在资源面板右键创建 C# 脚本后,双击脚本弹出的是系统记事本,没有语法高亮,也没有智能补全。
原因:Unity 的外部工具设置项没有指向 VS,或者 VS 安装时没有勾选与 Unity 相关的工作负载,项目文件生成的中间步骤缺失。
解决:在“编辑 → 首选项 → 外部工具”里把脚本编辑器指定为 VS;如果指定后仍然没效果,用 VS 的安装器补装上“游戏开发”相关负载,修复后重启。之后新建的脚本才会默认关联到 VS。
6. 安装完先做一次验证:控制台、统计面板与版本管理的小习惯
安装流程走完后,我一般不会急着写功能,而是先花几分钟确认四个东西都正常:许可证在 Hub 里显示有效,编辑器能打开新项目,控制台能看到自定义日志,游戏视图能跑起来。这四点确认完,这台机器的 Unity 环境才算真正可用。
第一个验证动作是创建空场景,在场景里放一个空物体,挂上 HelloUnity 脚本,点击播放,看控制台是否输出对应日志。能输出,说明渲染循环、脚本编译和游戏视图链路完整。第二个动作是打开游戏视图右上角的 Stats 面板,观察渲染状态和帧率是否有稳定数值。帧率一直为零或者数值异常跳动,优先怀疑显卡驱动和项目渲染设置,而不是 Unity 本身的问题。
日常使用里,我养成了三个小习惯。第一,新建项目时把路径写清为“英文盘符下的英文目录”,项目名能用拼音绝不用中文,从源头避开字体乱码和打包路径问题。第二,Hub 里的版本列表控制在两个以内,长期作业用一个 LTS 版本就够了,备份和还原时少一份混乱。第三,每次装完新版本,都做一个“空场景 + 测试脚本 + 安卓/WebGL 构建”的冒烟测试,模块缺什么当场补齐,不要等产品做了一半再回来补环境。
有一年我在一台新笔记本上直接拷贝了同事的项目,结果打开后报出一堆材质丢失和脚本编译错误。反复排查才发现,对方用的版本和我本机版本不一致,缺的模块也没有安装,问题根本不在项目本身。从那以后我每次换机器,都强制走一遍“Hub → 许可证 → 编辑器 → 组件 → 小工程验证”的全流程,十分钟的小事,省下的是半天环境排错时间。这套拆解的 Unity 详细安装教程就是按这个顺序写的:先理清四件套流程,再动手装,最后用最小工程收尾,祝你一次跑通,希望帮到你。
本文还有配套的精品资源,点击获取