在Unreal Engine中快速创建C++工程需先配置开发环境(VS/Xcode+SDK),再通过编辑器新建C++项目(选Blank模板、命名规范),最后验证TargetType、构建配置及IntelliSense设置。

在 Unreal Engine 中快速创建并配置 C++ 游戏工程,核心是利用引擎内置的 C++ 项目模板 + 正确的开发环境准备,避免手动配置编译工具链或修改构建脚本。整个过程通常 2–5 分钟即可完成,前提是本地已装好必要组件。
确保开发环境已就绪
UE 的 C++ 工程依赖 Visual Studio(Windows)或 Xcode(macOS)+ 对应的 Windows SDK / Command Line Tools。常见卡点不是代码,而是环境缺失:
- Windows:安装 VS 2022(含“使用 C++ 的桌面开发”工作负载 + Windows 10/11 SDK)
- macOS:安装 Xcode 并运行 xcode-select --install 和 sudo xcodebuild -license accept
- Linux:需手动安装 clang、make、ninja 等,官方支持有限,建议优先用 Windows/macOS 开发
- UE 编辑器必须通过 Epic Games Launcher 安装(非 GitHub 源码版),且启用“C++ 开发支持”选项
新建 C++ 项目(三步到位)
启动 UE 编辑器 → 新建项目 → 选择“Games”类别 → 切换到“C++”标签页 → 选“Blank”或“Basic Code”模板(不推荐“With Starter Content”,会增加首次编译时间):
- 项目名称不能含空格、中文或特殊符号(如 MyGame_v2 可,My Game! 不可)
- 勾选“Include Starter Content”仅当需要示例材质/模型;C++ 开发初期建议取消,加快编译
- 点击“Create”后,UE 自动调用 Visual Studio(或 Xcode)生成解决方案,并打开编辑器
首次编译与代码接入
新建项目后,编辑器会提示“正在编译……”,此时它已在后台调用 MSBuild(Windows)或 xcodebuild(macOS)生成项目文件。若失败,不要手动点“Compile”菜单,而是:
立即学习“C++免费学习笔记(深入)”;
- 关闭编辑器,双击项目目录下的 MyGame.sln(Windows)或 MyGame.xcworkspace(macOS)直接在 IDE 中编译
- 编译成功后,重新打开 .uproject 文件,编辑器将自动加载新二进制
- 在编辑器中右键点击内容浏览器 → “New C++ Class” → 选择 Actor 或 Pawn 等基类 → 输入类名(如 BP_PlayerCharacter)→ 确认,UE 自动在 Visual Studio 中打开对应头文件和 cpp 文件
关键配置检查项(避免后续踩坑)
项目创建后,立刻确认以下三项,能省去 80% 的构建报错:
- Target Type:在 Source/MyGame/MyGame.Target.cs 中,确保 Type = TargetType.Game;(不是 Client/Server)
- Build Configuration:VS 中设置为 Development Editor(非 DebugGame),否则编辑器无法热重载
- IntelliSense 支持:在 VS 中右键项目 → “Properties” → “Configuration Properties” → “General” → 确认 “Windows SDK Version” 与 UE 安装时匹配(如 10.0.22621.0)










