跳到主要内容

环境配置

本章将指导你完成 Unity 开发环境的安装和配置,包括 Unity Hub、Unity 编辑器以及必要的开发工具。

系统要求

最低配置

组件WindowsmacOS
操作系统Windows 10 (64-bit)macOS 10.13+
处理器x64 架构,支持 SSE2Apple Silicon 或 Intel x64
内存4 GB RAM4 GB RAM
显卡DX10、DX11、DX12 兼容Metal 兼容
存储空间10 GB 可用空间10 GB 可用空间

推荐配置

  • 内存:16 GB 或更多(大型项目需要)
  • 显卡:支持 DX12 或 Metal 的独立显卡
  • 存储:SSD,50 GB 以上可用空间
  • 显示器:1920×1080 或更高分辨率

安装 Unity Hub

Unity Hub 是管理 Unity 项目和编辑器版本的核心工具,所有 Unity 开发都应从安装 Unity Hub 开始。

Windows 安装

  1. 访问 Unity 官网下载页面
  2. 点击 Download Unity Hub 按钮
  3. 运行下载的 UnityHubSetup.exe
  4. 按照安装向导完成安装

macOS 安装

  1. 访问 Unity 官网下载页面
  2. 下载 UnityHubSetup.dmg
  3. 打开 DMG 文件,将 Unity Hub 拖到 Applications 文件夹

Linux 安装

Unity Hub 也支持 Linux,可从官网下载 AppImage 格式:

# 下载后赋予执行权限
chmod +x UnityHub.AppImage
./UnityHub.AppImage

创建 Unity 账号

使用 Unity 需要注册一个 Unity ID:

  1. 打开 Unity Hub
  2. 点击右上角 Sign inCreate account
  3. 填写邮箱、密码等信息完成注册
  4. 验证邮箱
许可证选择
  • Personal(个人版):年收入低于 10 万美元可免费使用
  • Plus/Pro:商业项目需要购买许可证

安装 Unity 编辑器

通过 Unity Hub 安装

  1. 打开 Unity Hub
  2. 点击左侧 Installs(安装)标签
  3. 点击右上角 Install Editor 按钮
  4. 选择版本:
    • 推荐选择最新的 LTS(长期支持)版本
    • 本教程基于 Unity 6 (6000.x) LTS
  5. 选择模块(Modules):
    • Windows/Mac/Linux Build Support:桌面平台支持
    • Android Build Support:Android 开发
    • iOS Build Support:iOS 开发(macOS 必需)
    • WebGL Build Support:网页游戏
    • Documentation:离线文档
    • Language Pack (Chinese):中文语言包

安装路径建议

C:\Program Files\Unity\Hub\Editor\
├── 6000.0.xf1\ # Unity 6 LTS
├── 2022.3.xf1\ # Unity 2022 LTS
└── ...

配置开发环境

安装 Visual Studio(推荐)

Visual Studio 是 Unity 开发的最佳 IDE,提供智能提示、调试等功能。

  1. 下载 Visual Studio Community
  2. 运行安装程序,选择工作负载:
    • 使用 Unity 的游戏开发(必须)
    • .NET 桌面开发(可选)

配置 Unity 与 Visual Studio 关联

  1. 打开 Unity 编辑器
  2. 菜单栏选择 Edit > Preferences(Windows)或 Unity > Settings(macOS)
  3. 选择 External Tools 标签
  4. External Script Editor 选择 Visual Studio
  5. 勾选 Generate .csproj files 下的所有选项

使用 Visual Studio Code(轻量选择)

如果你更喜欢轻量级编辑器:

  1. 安装 VS Code
  2. 安装扩展:
    • C# Dev Kit
    • Unity
  3. 在 Unity 中设置 External Script Editor 为 VS Code

创建第一个项目

新建项目步骤

  1. 打开 Unity Hub
  2. 点击左侧 Projects 标签
  3. 点击右上角 New Project 按钮
  4. 选择模板:
    • 3D Core:标准 3D 项目
    • 3D URP:通用渲染管线项目(推荐)
    • 2D (URP):2D 项目
    • 2D Core:传统 2D 项目
  5. 设置项目名称和位置
  6. 点击 Create Project

项目结构说明

创建项目后,你会看到以下文件结构:

MyFirstGame/                    # 项目根目录
├── Assets/ # 资源文件夹(所有游戏资源)
│ ├── Scenes/ # 场景文件
│ ├── Scripts/ # 脚本文件
│ ├── Prefabs/ # 预制体
│ └── ...
├── Packages/ # 包管理文件
├── ProjectSettings/ # 项目设置
├── UserSettings/ # 用户个人设置
└── Logs/ # 日志文件
重要提示
  • Assets 文件夹是唯一需要版本控制的文件夹
  • 不要在资源管理器中移动 Assets 内的文件,应在 Unity 编辑器内操作

常见问题解决

Unity Hub 无法启动

问题:双击 Unity Hub 无反应

解决方案

  1. 检查系统是否满足最低要求
  2. 尝试以管理员身份运行
  3. 删除配置文件夹后重启:
    • Windows: %APPDATA%\UnityHub
    • macOS: ~/Library/Application Support/UnityHub

编辑器安装失败

问题:下载或安装编辑器时出错

解决方案

  1. 检查网络连接
  2. 暂时关闭杀毒软件
  3. 手动下载编辑器安装包从官网
  4. 通过 Unity Hub 的 Locate 功能指向已下载的安装

Visual Studio 无法调试

问题:无法在 VS 中设置断点或调试

解决方案

  1. 确保安装了 "使用 Unity 的游戏开发" 工作负载
  2. 在 Unity 中确认 External Script Editor 设置正确
  3. 尝试重新生成项目文件:Assets > Open C# Project

中文显示问题

问题:界面中文显示乱码或不全

解决方案

  1. 确保安装了中文语言包模块
  2. 在 Preferences > Language 中选择简体中文
  3. 重启编辑器

验证安装

完成安装后,进行以下验证:

  1. 创建测试项目

    • 新建 3D URP 项目
    • 等待项目加载完成
  2. 测试脚本编辑

    • 在 Assets 文件夹右键 > Create > C# Script
    • 命名为 TestScript
    • 双击打开,确认能正常在 VS/VS Code 中打开
  3. 运行场景

    • 点击播放按钮(▶)
    • 确认 Game 视图正常显示
    • 再次点击停止播放
  4. 构建测试

    • File > Build Settings
    • 选择 PC, Mac & Linux Standalone
    • 点击 Build 测试是否能成功构建

下一步

环境配置完成后,你可以:

  1. 学习 编辑器界面 了解各窗口功能
  2. 创建你的第一个游戏对象
  3. 开始编写 C# 脚本