Unity安装配置全流程：Hub、许可证、编辑器与Android模块

简介：《Unity详细安装教程》是一份面向Unity零基础学习者与入门开发者的安装配置图文文档，围绕从环境准备到首次进入编辑器的完整链路展开，适合刚接触游戏开发、需要独立完成Unity环境搭建的人群使用。压缩包内仅有1个docx文件，大小约804KB，以图文结合的方式组织内容，便于在电脑端按章节阅读与查阅。教程覆盖Unity Hub获取、账号注册与个人版许可证激活、编辑器版本选择及组件模块追加、新项目创建、编辑器界面分区认知、中英文语言切换和外部脚本编辑器设置等关键环节，并对安装过程中容易忽略的路径命名、模块勾选和许可证过期提示作了说明。已有686人学习，可作为入门阶段排查环境问题、建立Unity工程结构的参考材料，帮助读者减少在安装配置上反复试错的成本，为后续场景搭建与脚本编写打好基础。

1. Unity 安装先装 Hub 再装编辑器：别让许可证卡在第一晚

Unity 安装这件事，很多人以为装完 Unity Hub 就结束了，真正容易翻车的是后面的许可证和编辑器模块。Hub 只是入口，编辑器本体、Android 模块、中文语言包、外部脚本工具都要在 Hub 里一层层选；许可证没激活，编辑器连启动都过不去。新手最容易在“账号登录跳网页”“个人版许可证过期”“安装模块漏勾 Android SDK”这三处卡住，熟手则常忽略安装路径和项目路径里的中文。适合刚接触 Unity 的开发者、做课程作业的学生、独立开发第一个 Demo 的人。把 Hub、许可证、编辑器、模块、项目路径按顺序拆开装，后面少很多返工。

2. 下载与安装 Unity Hub：安装包、路径和账号登录

Unity Hub 是管理器和下载器，不是编辑器本体。装好 Hub 只代表你有了一个入口，真正写代码、开场景的编辑器还要在 Hub 里单独下载。顺序上我一般会先确认下载目录、安装目录和磁盘剩余空间，再装 Hub，最后登录账号并激活个人版许可证。这个顺序别乱，尤其是许可证，编辑器启动时会检查它，先激活能少一次“装完打不开”的误判。

2.1 下载 Unity Hub 安装包：认准官方入口和文件类型

Windows 下 Hub 安装包是.exe文件，下载页面上 Hub 和 Unity 编辑器是分开的，先拿 Hub 就行。下载完成后别急着双击，先看文件名、文件大小和修改时间，确认不是被下载站改过名的包。常见做法是从官方下载页拿安装包，不用网盘里所谓的绿色版、免安装版，这类包经常缺数字签名或者夹带旧组件，后面激活许可证时问题很难查。

# 把路径换成你实际下载到的 Hub 安装包 $installer = "D:\Downloads\UnityHubSetup.exe" # 查看文件基本信息，确认文件存在且大小正常 Get-Item $installer | Select-Object Name, Length, LastWriteTime # 计算 SHA256，便于和下载页给出的校验值对照 Get-FileHash $installer -Algorithm SHA256

这段命令做两件事：先确认安装包真实存在、大小和修改时间是否合理，再算一个 SHA256 哈希。参数$installer要换成你自己的下载路径，-Algorithm SHA256表示用 SHA256 算法。哈希值本身不用记，它的作用是排除“下到一半断了”或者“被换包”的情况。下载页如果没给校验值，至少看一眼文件大小和数字签名，别从文件名都不对的来源拿包。

注意：安装包不要放在中文目录里再双击，部分安装器解压临时文件时会因为路径编码问题失败，表现是双击没反应或者弹一个很笼统的错误框。

2.2 双击安装与安装路径选择

双击安装包后，向导步骤不多：同意协议、选安装位置、创建快捷方式、完成。安装位置我一般会改成非系统盘的纯英文路径，比如D:\Unity\Hub，不放到C:\Program Files下面，也不要用中文和空格。Hub 本身不大，但它后面下载的编辑器、模块、缓存都会跟着这个目录走，路径干净一点，后面排错少绕弯。

# 安装前先检查计划使用的 Hub 目录是否含中文 $hubPath = "D:\Unity\Hub" if ($hubPath -match '[\u4e00-\u9fa5]') { Write-Host "路径含中文，建议换成纯英文路径" } else { Write-Host "路径检查通过" } # 安装完成后可以用这个命令启动 Hub，确认快捷方式没建错 Start-Process "D:\Unity\Hub\Unity Hub.exe"

第一段用正则匹配路径里有没有中文字符，[\u4e00-\u9fa5]覆盖常用中文区间。第二段Start-Process用来启动 Hub，路径要按你实际安装位置改；如果你安装时没改路径，默认位置可能不在D:\Unity\Hub，以向导里显示的为准。安装完成后先启动一次，看 Hub 能不能正常出界面，再往下走。

安装过程中如果 Windows 弹出权限提示，按默认允许即可，不需要长期用管理员身份跑 Hub。只有后面模块安装失败、目录写入被拒绝时，才临时用管理员身份启动一次，装完再退回去。长期管理员运行会让项目文件权限变乱，后面换普通账号打开项目反而容易出问题。

2.3 注册登录与个人版许可证激活

Hub 启动后第一件事是登录账号，不登录没法正常拿许可证。点右上角头像或者登录入口，会跳转到浏览器完成注册或登录，再回到 Hub。这里不要卡在“为什么点登录没反应”，多数情况是浏览器回调没回来，重新点一次或者把 Hub 完全退出再启动通常能恢复。账号注册完成后，回到 Hub 的许可证页面，点右上角“添加”，选个人版，也就是免费学习用的那个版本，点同意，界面显示获取成功才算完成。

# 查看 Unity 公共数据目录是否存在，许可证相关文件通常在这个目录附近 Get-ChildItem "$env:ProgramData\Unity" -Force -ErrorAction SilentlyContinue | Select-Object Name, LastWriteTime

这段命令只是确认 Unity 的公共数据目录有没有生成，-Force会把隐藏项也列出来，-ErrorAction SilentlyContinue表示目录不存在时不弹红字。注意不要手动去改许可证文件，也不要把别人的许可证文件拷过来，个人版许可证和账号绑定，拷文件解决不了登录状态问题。许可证过期时 Hub 会提示，重新点“添加”再选个人版即可，不需要重装编辑器。

提示：许可证激活失败时先看系统时间是否准确，时间偏差太大会让登录和许可证校验都异常；再确认浏览器能正常完成跳转，最后才考虑退出 Hub 重登。

3. 安装 Unity 编辑器：版本列表、模块勾选与存储规划

Hub 装好、许可证激活之后，才轮到编辑器本体。点 Hub 左侧“安装”，右上角“安装编辑器”，会列出可选版本。这里最容易犯的错是“看哪个新就装哪个”，结果项目模板、插件、教程对不上。我的习惯是先按项目需要选，没特殊要求就选长期支持版本，版本列表里能看到版本号和发布日期，别在教程里抄一个自己列表里没有的版本号。

3.1 在 Hub 的安装列表里选编辑器版本

版本选择要看三件事：现有项目用什么版本、要跟的教程用什么版本、插件支持到什么版本。全新学习环境不需要追最新，长期支持版本更稳，出了问题也更容易搜到同类记录。安装列表里每个版本后面会有安装按钮，点进去才是模块勾选。已经装过的版本会在“安装”页显示，后面追加模块也是从这一页进去。

# 查看已经安装到本地的编辑器版本目录 $editorRoot = "D:\Unity\Hub\Editor" Get-ChildItem $editorRoot -Directory -ErrorAction SilentlyContinue | Select-Object Name, LastWriteTime

这段命令列出编辑器安装根目录下的版本文件夹，Name就是版本号目录名，LastWriteTime能帮你判断哪个是刚装的。$editorRoot要按你 Hub 里实际的编辑器安装位置改，有人装在C:\Program Files\Unity\Hub\Editor，有人跟我一样放 D 盘。目录不存在时命令不会报错，只会没有输出，这时候先回 Hub 确认编辑器是不是真的装完了。

版本不是越多越好。每装一个版本，编辑器本体、模块、缓存都会占空间，项目切换时还容易点错版本。我一般只留一个主力版本和一个备用版本，过时的版本通过 Hub 版本右侧齿轮菜单里的“卸载”清掉，卸载前确认没有项目还在用这个版本打开。

3.2 安装组件与安卓模块的勾选

点“安装”后会弹出组件列表，编辑器默认会勾，Visual Studio 一般也默认勾上。要做 Android 包，就把 Android Build Support 以及它下面的 Android SDK & NDK Tools、OpenJDK 一起勾上，别只勾父项不勾子项，后面构建时会提示缺 SDK。中文语言包也在组件列表里，没有中文界面确实头疼，建议一开始就勾上，省得装完再回来追加。

# 安装前检查目标盘剩余空间，FreeGB 单位是 GB Get-PSDrive -PSProvider FileSystem | Select-Object Name, @{n='FreeGB';e={[math]::Round($_.Free/1GB,1)}}, Root

这段命令列出所有文件系统盘的剩余空间，@{n='FreeGB';e={...}}是计算属性，把字节换算成 GB 并保留一位小数。编辑器加模块加项目缓存，几十 GB 是常见量级，目标盘只剩几 GB 时先清空间再装，不要等下载到一半失败。Root列是盘符根路径，配合Name看你要装到哪个盘。

注意：Android 模块的 SDK、NDK、OpenJDK 是三个子项，安装时列表里要展开确认都勾上；只勾 Android Build Support 父项，后面打包仍可能提示工具链缺失。

3.3 安装后的模块追加、资源管理器定位与卸载

装完编辑器后如果发现漏了模块，不用重装。回到 Hub 的“安装”页，点对应版本右侧的齿轮，选“添加模块”，把漏掉的组件补勾上再安装。齿轮菜单里还有“在资源管理器中显示”，就是打开本地编辑器文件夹，排查日志、看安装目录时很方便。“卸载”则是把当前版本清掉，版本过时或者装错盘时用，卸载前先确认没有项目依赖这个版本。

# 直接打开编辑器安装根目录，方便核对版本文件夹 $editorRoot = "D:\Unity\Hub\Editor" Start-Process explorer.exe $editorRoot

Start-Process explorer.exe用资源管理器打开指定目录，路径变量按实际安装位置改。这个操作不修改任何文件，只是省得一层层点进去。追加模块时如果 Hub 提示需要关闭编辑器，先把 Unity 编辑器退出，再点添加模块，装完重新打开项目。

卸载编辑器不会自动删项目，但会把编辑器目录清掉。项目里如果用了这个版本特有的包，换版本打开时可能触发重新导入。我的做法是卸载前把项目用主力版本打开一次，确认能升级再删旧版本，别一上来就清目录。

3.4 存储空间与安装路径规划

比较稳的目录规划是：Hub 一个目录、编辑器一个目录、项目一个目录、缓存一个目录，全部纯英文路径。项目里的Library文件夹是导入缓存，删了会重新生成，但它往往占几个 GB，磁盘紧张时先看这里。不要把项目放在 Hub 安装目录下面，也不要把项目放在桌面或者下载目录，后面迁移和备份都麻烦。

# 统计某个项目 Library 缓存占用，单位 GB $project = "D:\UnityProjects\MyFirstProject" $library = Join-Path $project "Library" Get-ChildItem $library -Recurse -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum | Select-Object @{n='LibraryGB';e={[math]::Round($_.Sum/1GB,2)}}

这段命令用Join-Path拼出项目的Library目录，再递归统计文件长度总和。Measure-Object -Property Length -Sum做求和，LibraryGB是换算后的 GB 数。项目路径要换成你自己的，Library不存在时输出为空，说明项目还没导入过或者路径不对。缓存大不等于要马上删，只有确认项目能重新导入时再动它。

4. 创建项目与编辑器配置：模板、中文路径和外部脚本工具

编辑器装完，下一步是创建项目并做几项固定配置：模板、项目路径、中英文切换、外部脚本编辑器。这几项在第一次打开项目时设置好，后面少很多“脚本打不开”“菜单看不懂”“项目编译失败”的问题。创建项目本身不复杂，麻烦的是路径和默认工具，尤其是中文路径，很多人是项目做了一半才搬，搬完包引用全断。

4.1 新项目模板：3D、2D 和模板类型怎么选

Hub 里点“项目”右上角“新项目”，弹窗分三列：左边模板类型，中间详细类型，右边项目名和本地位置。做 3D 游戏选 3D 模板，做 2D 游戏选 2D 模板。3D 模板也能做 2D，只要不使用第三轴向，但模板终归是框架，后面材质、物理、相机设置都要自己调，新手按目标类型选更省事。已经有现成项目就用旁边的“打开”，不要在新项目里再导入一次。

模板选错不用慌，项目创建后仍可以改设置、换渲染管线、调相机投影。真正不能凑合的是项目路径和版本，模板只是起点。创建时如果勾了云端存储，后面换机器会方便一些，但项目大时同步会慢，本地项目建议先把本地目录管好。

4.2 项目名称、本地位置与中文路径的坑

项目名用英文、数字、下划线，别用中文和空格。项目位置也一样，D:\UnityProjects\MyFirstProject这种路径最省心。中文路径在 Windows 上不一定立刻报错，但会在包导入、脚本编译、Android 构建、命令行调用时随机出问题，属于典型的玄学故障。与其后面搬项目，不如创建时就定好。

# 创建项目前检查路径是否含中文 $projectPath = "D:\UnityProjects\MyFirstProject" if ($projectPath -match '[\u4e00-\u9fa5]') { Write-Host "路径含中文，建议更换后再创建项目" } else { Write-Host "路径检查通过" }

这段判断和前面 Hub 路径检查一样，-match用正则找中文区间。$projectPath换成你准备填进 Hub 的完整路径，不要只写项目名。路径检查通过不代表目录一定可写，还要确认当前账号对这个目录有写权限，尤其是放在系统盘或者别人建的目录下时。

提示：项目名和路径都不要带中文、空格和特殊符号；已经建好的项目如果路径含中文，先备份再迁移，不要直接在原目录改文件夹名。

4.3 中英文切换：语言包与首选项

安装时勾了中文语言包，编辑器菜单一般会显示中文。想切回英文，点菜单栏“编辑”->“首选项”，在弹出窗口里找“简体中文”或者“Languages”，右边下拉菜单改语言，重启编辑器生效。反过来从英文切中文也一样，前提是语言包已经装了。没装语言包时列表里不会出现中文选项，回 Hub 给对应版本追加模块。

语言设置是编辑器级别，不是项目级别。换项目一般不用重设，但换编辑器版本后要重新确认一次。菜单路径在不同版本里文字可能略有差异，认“首选项”和“Languages”这两个关键词就行。

4.4 外部脚本编辑器：把 VS 设成默认打开方式

Unity 默认用 Visual Studio 打开脚本，但设置位置要知道。还是在“编辑”->“首选项”里，找“外部工具”，右边脚本编辑器下拉选 Visual Studio。机器上装了多个 VS 版本时，这里会列出多个，选你实际用来写 C# 的那个。只有一个版本时一般不会乱，多个版本时选错会出现双击脚本打开旧版 IDE、断点打不上、智能提示不工作。

# 列出常见 Visual Studio 安装目录，确认本机装了哪些版本 Get-ChildItem "C:\Program Files\Microsoft Visual Studio" -Directory -ErrorAction SilentlyContinue | Select-Object Name, FullName

这段命令只列目录，不启动 VS，-ErrorAction SilentlyContinue用于目录不存在时不报错。输出里的Name可能是年份或版本目录，FullName是完整路径。路径因安装位置不同会有差异，如果这里没有输出，去C:\Program Files (x86)或者你自定义的安装盘再看一眼。确认有 VS 之后回 Unity 首选项里选，不要手填一个不存在的路径。

设置完做一次验证：在项目Assets下右键创建 C# 脚本，双击它，看是不是用预期的 VS 打开。如果打开的是记事本或者另一个编辑器，回“外部工具”重新选。改完设置不需要重装 Unity，但建议重启一次编辑器再试。

4.5 界面面板快速核对：层级、属性、场景、游戏、资源、控制台

新建项目后界面看起来东西很多，先认几个核心区域。层级面板显示当前场景里的游戏物体，初始场景默认有灯光和摄像机。点层级里的物体，右边属性面板会列出它的组件和参数，移动、旋转、缩放都在这里调。中间是场景窗口和游戏窗口，场景窗口用来编辑，游戏窗口是运行时摄像机看到的画面。下方资源文件面板对应本地项目的Assets目录，项目里创建的文件都会收在这里。资源面板旁边是控制台，脚本有没有执行、有没有报错，都看这里。

控制台是后面验证安装是否跑通的关键。脚本里写一句输出，运行后控制台能看到，说明脚本编译和执行链路是通的；看不到就查脚本有没有挂到场景物体上、有没有保存、控制台有没有红色报错。界面布局被拖乱时，右上角布局下拉里可以恢复默认，不用重装。

5. 常见问题排查：许可证、模块、启动和控制台的救火清单

Unity 安装问题看起来玄学，其实大部分能归到许可证、下载缓存、项目路径、权限四类。排查时先别急着重装，重装会清掉现场，反而找不到原因。我一般先看 Hub 和编辑器的日志，再看路径和权限，最后才动卸载。下面几条是装 Hub 和编辑器时最常遇到的翻车记录，按现象、原因、解决拆开写。

5.1 许可证与账号：过期、激活失败、登录跳转

现象一：Hub 显示许可证过期或者没有许可证，编辑器点启动没反应。原因多半是个人版许可证到期，或者账号退出后没有重新激活。解决是回 Hub 许可证页面，点右上角“添加”，重新选个人版并同意，界面显示获取成功后再启动编辑器。不要靠重装编辑器解决许可证问题，重装不会自动续期。

# 查看当前系统时间，时间偏差会影响登录和许可证校验 Get-Date # 查看 Windows 时间服务状态，确认系统时间是否在自动同步 w32tm /query /status

Get-Date看当前时间，w32tm /query /status看时间服务状态。时间不准时先校准系统时间，再重新登录 Hub。命令不需要管理员权限，输出里的时间源和同步状态可以帮你判断是不是本机时间跑偏。

现象二：点登录一直跳浏览器，回到 Hub 还是未登录。原因常见是默认浏览器没有正确回调，或者 Hub 进程卡在旧状态。解决是先把 Hub 完全退出，包括托盘图标，再重新启动；还不行就把登录链接复制到浏览器里完成，最后回 Hub 刷新。默认浏览器被改来改去时，固定一个能正常跳转的浏览器再试。

5.2 编辑器下载与模块安装：进度卡住、校验失败

现象：编辑器下载到一半卡住，或者模块安装到最后提示失败。原因可能是磁盘空间不足、下载缓存损坏、安装目录权限不够，也可能是模块子项没勾全。解决顺序是先看目标盘剩余空间，再看 Hub 日志，最后回版本齿轮里补装模块。不要不停点重试，失败次数多了缓存更容易乱。

# 查看 Hub 日志目录下最近的日志文件 $hubLogDir = "$env:APPDATA\UnityHub\logs" Get-ChildItem $hubLogDir -ErrorAction SilentlyContinue | Sort-Object LastWriteTime -Descending | Select-Object -First 5 Name, LastWriteTime

$env:APPDATA指向当前用户的漫游数据目录，Hub 日志通常在这下面。Sort-Object LastWriteTime -Descending按修改时间倒序，Select-Object -First 5只取最近五个。日志文件名和目录在不同 Hub 版本里可能略有差异，找不到时先在资源管理器地址栏输入%APPDATA%\UnityHub看目录结构。

模块安装失败还要检查 Android 子项。只勾 Android Build Support 不勾 SDK & NDK Tools 和 OpenJDK，后面打包会提示缺工具链。回 Hub 版本齿轮里选“添加模块”，把三个子项一起补上再装。

5.3 项目打开与启动：白屏、闪退、控制台报错

现象：新建项目后卡在导入界面，或者编辑器白屏、闪退。原因可能是首次导入本来就慢、项目路径有问题、显卡驱动旧、编辑器版本和模板不匹配。解决是先等首次导入完成，不要连续点窗口；超过合理时间再看编辑器日志。控制台有红色报错时先解决第一条，后面的报错经常是连锁反应。

# 查看编辑器日志最后 80 行，定位启动失败原因 $editorLog = "$env:LOCALAPPDATA\Unity\Editor\Editor.log" if (Test-Path $editorLog) { Get-Content $editorLog -Tail 80 } else { Write-Host "没有找到 Editor.log，确认编辑器是否至少启动过一次" }

$env:LOCALAPPDATA是当前用户的本地应用数据目录，Test-Path先判断日志存在，Get-Content -Tail 80只读末尾 80 行。日志很长，从末尾往前看效率最高。找不到日志说明编辑器可能还没成功启动过，或者安装不完整，回 Hub 确认版本目录。

现象：脚本写完了，运行后控制台没有任何输出。原因通常不是安装坏了，而是脚本没保存、没挂到场景物体、物体没启用，或者运行的是另一个场景。解决是确认脚本保存后拖到层级里的物体上，物体处于激活状态，再点运行。控制台清空后再跑一次，避免旧输出干扰。

5.4 路径与权限：中文路径、只读目录、杀毒拦截

现象：项目能打开，但脚本编译失败、包导入失败，或者 Android 构建到一半报路径错误。原因常见是项目路径含中文或空格、目录只读、当前账号权限不足，也可能是安全软件拦截了编译生成的临时文件。解决是把项目迁到纯英文路径，确认目录可写，再把 Unity 相关目录加入安全软件白名单。

# 把项目从旧目录迁到纯英文目录，先确认目标目录不存在同名项目 $source = "D:\OldProjects\MyFirstProject" $target = "D:\UnityProjects\MyFirstProject" robocopy $source $target /E /MOVE

robocopy是 Windows 自带复制工具，/E表示包含子目录包括空目录，/MOVE表示复制后删除源文件。迁移前先备份，确认 Unity 编辑器已经关闭，目标路径不要含中文。迁移完成后用 Hub 的“打开”重新指向新目录，不要直接双击旧快捷方式。

权限问题还有一类是安装目录被设成只读，模块追加时写不进去。解决是检查安装目录属性，必要时临时用管理员身份启动 Hub 完成模块安装，装完再用普通身份打开项目。不要长期管理员运行，项目文件权限会变得混乱。

6. 装完怎么验证跑通：从空场景到控制台输出

验证 Unity 装没装好，不要只看 Hub 能不能打开。比较稳的办法是新建一个空项目，创建一个脚本，挂到场景物体上，运行后看控制台有没有输出。这个流程能同时验证编辑器启动、脚本编译、外部工具关联和运行时环境。先建项目，项目路径用纯英文，模板选 3D 或 2D 都行，进编辑器后等首次导入结束。

using UnityEngine; public class InstallCheck : MonoBehaviour { void Start() { // 输出固定标记，控制台能看到就说明脚本编译并执行了 Debug.Log("Unity 安装验证：脚本已执行"); // 打印当前编辑器版本，确认打开的是预期版本 Debug.Log($"当前编辑器版本：{Application.unityVersion}"); // 打印项目路径，顺便检查有没有中文路径 Debug.Log($"项目路径：{Application.dataPath}"); } }

这段脚本放在Assets目录下，文件名和类名保持一致，比如InstallCheck.cs。Start在物体启用后执行一次，Debug.Log把信息打到控制台。Application.unityVersion是当前编辑器版本，Application.dataPath是项目Assets目录的绝对路径。脚本写完后回编辑器等编译完成，在层级面板新建一个空物体，把脚本拖上去，点运行，看控制台有没有三行输出。

再补一个目录检查，确认项目骨架完整。新项目至少应该有Assets、Packages、ProjectSettings三个目录，缺一个都说明项目没创建完整。

# 检查项目骨架目录是否存在 $project = "D:\UnityProjects\MyFirstProject" "Assets", "Packages", "ProjectSettings" | ForEach-Object { $path = Join-Path $project $_ [PSCustomObject]@{ 目录 = $_ 存在 = Test-Path $path } }

ForEach-Object把三个目录名逐个拼成完整路径，Test-Path返回 True 或 False。项目路径换成你自己的，输出全是 True 才算骨架完整。如果Assets不存在，回 Hub 重新打开项目或者重新创建，不要手动补空目录，手动补的目录缺项目配置，编辑器仍会重新生成。

装完这一遍，我一般还会把 Hub 安装路径、编辑器版本目录、项目路径记到自己的安装清单里，下次换机器直接照着填。从那以后我每次装完 Unity 都强制走一遍空项目加控制台输出，不再凭 Hub 能打开就判断装好了。希望帮到你。

本文还有配套的精品资源，点击获取