TEngine 入门系列（二）：三件套环境搭建 -- Unity + TEngine + AI 助手

烛阴2026-05-13 16:01

前言

上一篇我们搞清楚了 TEngine 是什么、为什么选它。这一篇进入实操环节------搭建完整的开发环境。

我们要装好"三件套"：

  1. Unity：游戏引擎本体
  2. TEngine：游戏框架
  3. AI 助手：你的编程搭档（Claude Code）

本篇会非常详细，每一步都有说明，确保零基础也能顺利搭完环境。搭完之后，你的开发环境就具备了"引擎 + 框架 + AI"三重加速能力。

一、Unity 环境搭建

1.1 安装 Unity Hub

Unity Hub 是 Unity 官方的项目管理器，所有 Unity 版本都通过它来安装和管理。

安装步骤：

  1. 打开 Unity 官网下载页面：https://unity.com/download
  2. 点击"Download Unity Hub"，下载对应系统的安装包
  3. 运行安装包，一路默认即可
  4. 安装完成后打开 Unity Hub，注册或登录 Unity 账号

1.2 选择 Unity 版本

TEngine 对 Unity 版本有兼容性要求。选错版本会导致各种莫名其妙的报错。

版本选择建议：

版本类型 特点 推荐度
LTS（长期支持版） 稳定，Bug 少，企业首选 强烈推荐
最新正式版 新功能多，但可能有兼容问题 不推荐新手
Tech Stream（预览版） 实验性功能，不稳定 不要用

推荐版本：Unity 2021.3.20f1c1（TEngine 官方推荐）

具体以 TEngine GitHub 仓库的 README 说明为准。

安装 Unity 编辑器：

  1. 在 Unity Hub 左侧点击"Installs"（安装）
  2. 点击"Install Editor"
  3. 选择推荐的 LTS 版本
  4. 勾选以下模块（根据你的目标平台）：
    • 必选 ：Microsoft Visual Studio 或你已有的 IDE
    • Android 开发 ：Android Build Support（含 SDK & NDK）
    • iOS 开发 ：iOS Build Support（仅 macOS）
    • WebGL 发布 ：WebGL Build Support
  5. 点击安装，等待下载完成（约 2~5 GB）

1.3 新建 Unity 项目

安装完成后，创建第一个项目：

  1. 在 Unity Hub 点击"New Project"
  2. 选择模板：3D (Built-in Render Pipeline)

为什么选 Built-in 而不是 URP？

渲染管线 优点 缺点 TEngine 兼容性
Built-in 教程多、插件兼容好、上手简单 性能优化空间有限 完全兼容
URP 性能好、适合移动端 部分插件不兼容、Shader 需适配 兼容
HDRP 画质最好 性能要求高、手游不适用 不推荐

新手建议从 Built-in 开始，后期熟悉后再迁移到 URP。

  1. 设置项目名称：TEngine-Tutorial
  2. 选择保存路径（避免中文路径和空格）
  3. 点击"Create project"

1.4 编辑器基本设置

项目创建后，先做几项关键设置：

设置 .NET 版本：

复制代码 
Edit → Project Settings → Player → Other Settings → Configuration
→ Api Compatibility Level → .NET Framework（或 .NET Standard 2.1）

TEngine 需要较完整的 .NET API 支持，如果设为 .NET Standard 2.0 可能会缺少部分类库。

设置颜色空间（推荐）：

css 复制代码 
Edit → Project Settings → Player → Other Settings → Rendering
→ Color Space → Linear

Linear 颜色空间在光照计算上更准确，是现代游戏的标准选择。

设置脚本编辑器：

sql 复制代码 
Edit → Preferences → External Tools → External Script Editor
→ 选择你的 IDE（Visual Studio / VS Code / Rider）

二、导入 TEngine

2.1 获取 TEngine

TEngine 是开源项目，托管在 GitHub 上。获取方式有两种：

方式 适合谁 优点 缺点
Git Clone 有 Git 经验的开发者 方便更新、可提交 PR 需要安装 Git
Download ZIP 纯新手 最简单，解压即用 无法方便地更新版本

新手推荐：Download ZIP 方式

  1. 打开 TEngine 的 GitHub 仓库页面：https://github.com/Alex-Rachel/TEngine
  2. 点击绿色的 "Code" 按钮 → "Download ZIP"
  3. 解压到一个无中文、无空格的路径下
  4. 在 Unity Hub 中，用"Open" → "Add project from disk"打开解压后的 UnityProject 目录

TEngine 仓库本身就是一个完整的 Unity 项目，不需要自己新建项目再导入。直接用 Unity Hub 打开仓库中的 UnityProject 文件夹即可。

2.2 目录结构解读

TEngine 的项目结构经过精心设计，将框架代码、美术资源、热更资源、游戏逻辑清晰分离。理解这个结构是高效开发的基础：

css 复制代码 
Assets/
├── AssetArt/                 ← 美术资源目录
│   └── Atlas/                ← 自动生成图集目录
├── AssetRaw/                 ← 热更资源目录（会被打进 AssetBundle）
│   ├── UIRaw/                ← UI 图片目录
│   │   ├── Atlas/            ← 需要自动生成图集的 UI 素材
│   │   └── Raw/              ← 不需要生成图集的 UI 素材
│   ├── Audios/               ← 音频资源
│   ├── Effects/              ← 特效资源
│   └── Scenes/               ← 场景资源
├── Editor/                   ← 编辑器脚本目录
├── HybridCLRData/            ← HybridCLR 热更相关目录
├── Scenes/                   ← 主场景目录（Launcher 场景在这里）
├── TEngine/                  ← 框架核心目录（不要修改！）
│   ├── Runtime/              ← 运行时核心代码
│   ├── Editor/               ← TEngine 编辑器扩展
│   └── AssetSetting/         ← YooAsset 资源打包配置
└── GameScripts/              ← 程序集目录（你的代码放这里）
    ├── Procedure/                 ← 主程序程序集（启动器与流程）
    └── HotFix/               ← 热更新程序集目录
        ├── GameBase/         ← 游戏基础框架程序集 [Dll]
        ├── GameProto/        ← 游戏配置协议程序集 [Dll]
        └── GameLogic/        ← 游戏业务逻辑程序集 [Dll]
            ├── GameApp.cs                  ← 热更主入口
            └── GameApp_RegisterSystem.cs   ← 热更主入口注册系统

关键目录说明：

目录 用途 你需要关注吗
TEngine/ 框架核心代码 只读，不要修改（方便升级）
GameScripts/HotFix/GameLogic/ 你的游戏业务逻辑 核心工作区，大部分代码写在这里
GameScripts/Procedure/ 启动器和流程代码 偶尔修改（配置启动流程）
AssetRaw/ 需要热更的资源 美术资源、UI 图片、音频等放这里
AssetArt/ 美术资源（图集等） 美术相关
HybridCLRData/ 热更新编译产物 自动生成，不需要手动管理

关键原则：

  • TEngine/ 目录下的代码不要修改，方便后续更新框架版本
  • 你的游戏代码放在 GameScripts/HotFix/GameLogic/ 下
  • 需要热更新的资源放在 AssetRaw/ 下
  • TEngine 采用程序集分离设计：Procedure 是主包代码，HotFix 下的代码支持热更新

2.3 跑通第一个 Demo

导入完成后，先确认环境没有问题：

  1. 打开项目 ：用 Unity Hub 打开 UnityProject 目录，等待编译完成
  2. 检查控制台 ：Window → General → Console，确认没有红色错误
  3. 选择运行模式 ：在顶部菜单栏选择 EditorMode（编辑器模拟模式）
  4. 打开 Launcher 场景 ：在 Assets/Scenes/ 下找到 Launcher 场景，双击打开
  5. 点击 Play：运行场景，确认能正常运行
  6. 如果一切正常：恭喜，TEngine 环境搭建成功！

2.4 常见报错排查

如果控制台出现红色错误，别慌。90% 的问题都是以下几种：

报错信息 原因 解决方案
The type or namespace 'xxx' could not be found 缺少依赖包 检查是否安装了 YooAsset 等依赖
API Compatibility Level 相关错误 .NET 版本不对 改为 .NET Framework
Shader error 渲染管线不匹配 确认使用 Built-in 而非 HDRP
Assembly 'xxx' has references to missing assemblies 程序集引用缺失 重新导入 TEngine 或检查 .asmdef 文件
Failed to resolve packages 网络问题导致 UPM 包下载失败 检查网络或切换 Unity 包管理器的镜像源

万能排查三步法：

  1. 仔细阅读报错信息的第一行
  2. 复制报错信息搜索引擎搜索
  3. 检查 TEngine 的 GitHub Issues 是否有相同问题

三、AI 开发环境搭建

TEngine 深度集成了 AI 辅助开发工作流。本节我们搭建两个核心工具：Claude Code （AI 编程助手）和 Unity-MCP（让 AI 直接操作 Unity 编辑器）。

3.1 安装 Claude Code

Claude Code 是 TEngine 官方推荐的 AI 编程助手。项目已内置 CLAUDE.md 配置和 tengine-dev skill，开箱即用。

安装步骤：

  1. 访问 https://claude.ai/code 下载 Claude Code
  2. 安装后登录 Anthropic 账号
  3. 进入 TEngine 项目目录启动：
bash 复制代码 
cd /path/to/TEngine/UnityProject
claude

TEngine 已经帮你配好了：

打开项目后，Claude Code 会自动读取仓库中的 CLAUDE.md，其中定义了技术栈、目录约定、代码规范、各模块 API 使用方式。你不需要自己写配置文件，直接开始用。

tengine-dev skill 的工作方式：

当你提出开发任务时，AI 会根据任务复杂度自动决定查询深度：

任务等级 判断标准 AI 的行为
L1 简单 typo 修正、注释修改 直接编码，不查询规范
L2 调用 单一模块的 API 修改 查询该模块规范后编码
L3 功能 新功能开发、跨文件修改 查询所有相关模块规范后编码
L4 架构 系统设计、模块重构 并行查询多个模块规范，汇总后给出方案

3.2 安装 Unity-MCP（AI 操作 Unity 编辑器）

Unity-MCP（AI Game Developer）是让 AI 直接操控 Unity 编辑器的桥梁。它通过 MCP（Model Context Protocol）将 Claude Code 连接到 Unity，安装后你可以用自然语言让 AI 在 Unity 中创建场景、修改物体、生成预制体、运行测试------不需要手动操作编辑器。

与其他工具不同，Unity-MCP 不仅支持编辑器操作，还可以在已编译的游戏内部工作，支持实时 AI 调试和玩家与 AI 的交互。

⚠️ 系统要求 ：项目路径不能包含空格。例如 C:/MyProjects/MyProject ✅，C:/My Projects/My Project ❌

Unity-MCP 能做什么：

插件内置 100+ 个工具，分为三大类别，安装后所有工具立即可用：

类别 能力 示例
项目与资产 查找/创建/移动/删除资产、创建预制体、管理包 "把这个 GameObject 保存为预制体"
场景与层级 创建/修改 GameObject、添加组件、截图 "在场景中创建一个带 Rigidbody 的立方体"
脚本与编辑器 读写脚本、动态执行 C# 代码、运行测试、查看日志 "运行游戏并截图给我看看效果"

安装方式一：下载安装器（推荐新手）

  1. 下载安装器：访问 https://github.com/IvanMurzak/Unity-MCP/releases，下载最新的 AI-Game-Dev-Installer.unitypackage
  2. 导入 Unity：双击下载的 .unitypackage 文件，Unity 会自动打开导入窗口（也可以在 Unity 编辑器中点击 Assets → Import Package → Custom Package 选择文件）
  3. 点击 Import 导入所有文件

安装方式二：CLI 安装（推荐）

通过 unity-mcp-cli 命令行工具安装，无需打开 Unity 编辑器即可完成：

bash 复制代码 
# 1. 安装 unity-mcp-cli
npm install -g unity-mcp-cli

# 2. 在 TEngine 项目中安装 "AI Game Developer" 插件
unity-mcp-cli install-plugin ./TEngine/UnityProject

# 3. 登录云服务器（用于远程 MCP 通信）
unity-mcp-cli login ./TEngine/UnityProject

# 4. 打开 Unity 项目（自动连接并生成技能）
unity-mcp-cli open ./TEngine/UnityProject

# 5. 等待 Unity Editor 准备就绪
unity-mcp-cli wait-for-ready ./TEngine/UnityProject

3.3 配置 Claude Code 连接 Unity-MCP

安装完 Unity-MCP 插件后，需要让 Claude Code 能够通过 MCP 协议与 Unity 通信。有两种配置方式：

方式一：Unity 编辑器自动配置（推荐）

  1. 打开 Unity 编辑器
  2. 打开菜单 Window → AI Game Developer
  3. 点击 Auto-generate 按钮自动生成技能（推荐），或点击 Configure 手动配置 MCP 连接
  4. 在弹出的配置窗口中选择 Claude Code，插件会自动完成配置

方式二：命令行手动配置

如果自动配置不工作，可以用 Claude Code CLI 手动添加 MCP 服务器：

bash 复制代码 
# 根据你的操作系统选择对应的命令

# macOS (Apple Silicon)
claude mcp add ai-game-developer "<项目路径>/Library/mcp-server/osx-arm64/unity-mcp-server" port=<端口号> client-transport=stdio

# macOS (Intel)
claude mcp add ai-game-developer "<项目路径>/Library/mcp-server/osx-x64/unity-mcp-server" port=<端口号> client-transport=stdio

# Windows x64
claude mcp add ai-game-developer "<项目路径>/Library/mcp-server/win-x64/unity-mcp-server.exe" port=<端口号> client-transport=stdio

# Linux x64
claude mcp add ai-game-developer "<项目路径>/Library/mcp-server/linux-x64/unity-mcp-server" port=<端口号> client-transport=stdio

其中 <项目路径> 替换为你的 Unity 项目完整路径，<端口号> 替换为 AI Game Developer 配置窗口中显示的端口号。

方式三：CLI 一键配置

bash 复制代码 
npx unity-mcp-cli setup-skills claude-code ./TEngine/UnityProject

验证连接：

配置完成后，在 Claude Code 中输入：

复制代码 
在场景中以半径 2 的圆形排列创建 3 个红色立方体，
每个立方体添加 Rigidbody 组件，
然后运行游戏截图给我看效果

AI 会通过 Unity-MCP 直接在 Unity 编辑器中完成所有操作------创建物体、设置颜色、添加组件、运行游戏、截图返回。全程不需要你手动操作编辑器。

3.4 两个工具如何配合

css 复制代码 
你（自然语言）
    ↓
Claude Code（理解需求，生成代码）
    ↓  ← tengine-dev skill 提供 TEngine 框架规范
    ├→ 创建/修改 .cs 脚本文件（Claude Code 直接写文件）
    └→ 操作 Unity 编辑器（通过 Unity-MCP）
        ├→ 创建 GameObject、Prefab
        ├→ 修改场景、添加组件
        ├→ 运行游戏、查看日志
        └→ 截图反馈效果
工具 负责什么 类比
Claude Code 写代码、理解需求、设计架构 程序员的大脑
tengine-dev skill 提供 TEngine 框架规范 程序员手边的文档
Unity-MCP 操作 Unity 编辑器 程序员的双手

3.5 AI 使用注意事项

1. 生成的代码必须验证

AI 有时会"编造" API。永远在 Unity 里编译运行验证。TEngine 的 tengine-dev skill 会大幅减少这类问题------它从框架的 references 文档中提取正确 API。

2. 先理解再使用

  • 先让 AI 解释原理
  • 再让 AI 生成代码
  • 逐行阅读理解
  • 然后运行验证

3. 描述越具体，结果越好

objectivec 复制代码 
// 差的提示词
帮我写一个 UI

// 好的提示词
帮我创建一个 TEngine 的 UISettingPanel，继承 UIWindow，
放在 GameScripts/HotFix/GameLogic/ 目录下，
包含一个 Slider 控制 BGM 音量（范围 0~1），
一个 Toggle 控制音效开关，
一个返回按钮点击后关闭当前面板，
使用 GameEvent 广播音量变化事件

四、验证环境

所有安装完成后，做一个最终验证：

4.1 检查清单

检查项 如何验证 预期结果
Unity 版本正确 Unity Hub → Installs 查看 2022.3 LTS 或指定版本
TEngine 已导入 项目中有 Assets/TEngine/ 目录 目录存在且不为空
编译无报错 Console 窗口检查 没有红色错误
示例能运行 打开示例场景按 Play 正常运行，无崩溃
AI 工具可用 在 Claude Code 中向 AI 提问 能收到回复
Unity-MCP 已连接 Claude Code 中执行 Unity 操作 能正常操控 Unity 编辑器
CLAUDE.md 项目根目录检查 文件存在且内容正确

4.2 创建你的第一个脚本

创建一个简单脚本验证 TEngine 能正常调用：

csharp 复制代码 
using UnityEngine;
using TEngine;

/// <summary>
/// 环境验证脚本 - 确认 TEngine 框架正常工作
/// </summary>
public class EnvironmentCheck : MonoBehaviour
{
    void Start()
    {
        // 测试 TEngine 日志系统
        Log.Info("TEngine 环境验证成功！");
        Log.Info($"Unity 版本: {Application.unityVersion}");
        Log.Info($"平台: {Application.platform}");
        Log.Info("恭喜！你的开发环境已经就绪，可以开始学习了。");
    }
}

将这个脚本挂到场景中任意 GameObject 上，按 Play 运行。如果 Console 中看到"TEngine 环境验证成功！"，说明一切就绪。

相关推荐
逍遥归来2 小时前
如何在 Jenkins 打包流程中接入 SwiftLint 自动化扫描
前端
wuxianda10302 小时前
uniapp项目上架苹果商店4.3a被拒，3天极速解决方案2026.5.8
前端·人工智能·flutter·uni-app·ios上架·苹果上架·苹果4.3a
前端毕业班2 小时前
前端"枚举"管理指南
前端·javascript
yuandiv2 小时前
告别"薛定谔的测试"：Flaky Test 全链路治理实战
前端
明月_清风2 小时前
Claude Code 保姆级入门教程：零基础到 AI 编程高手，看这一篇就够了
前端·后端·claude
ricardo19733 小时前
手写一个虚拟列表，万级数据滚动 FPS 稳定 60 帧
前端
小KK_3 小时前
新手必看：一篇文章带你搞懂JavaScript作用域
前端
万邦科技Lafite3 小时前
如何通过 item_search_img API 接口获取淘宝商品信息
java·前端·数据库
AlbertZein3 小时前
干了三年全栈才悟到：TS + React 这套组合，真不是堆技术堆出来的
前端
热门推荐
01GitHub 镜像站点02Codex 接入 DeepSeek API 完整配置文档03CC-Switch & Claude 基于 Linux 服务器安装使用指南04【AI】2026 年具身智能模型和世界模型总结05零基础教你claude code 接入 deepseek V406Cursor 接入 DeepSeek‑V4‑Pro 完整指南（2026 实测）07codex app每次打开重连5次Reconnecting问题解决08Windows端Codex接入第三方模型（DeekSeek，BaiLian)09裂开！ChatGPT 居然开始要手机号验证，附详细解决方法10要裂开了！ChatGPT要手机号验证了？注册Codex要求验证电话号码怎么办？2026年登陆Codex要手机号验证的解决办法