讲师中心 微信公众号
AI工具推荐 视频效率加速

vscode如何配置Unreal Engine(UE)开发环境

老瑶君_4038

老瑶君_4038

发布时间:2026-03-19 12:40:31

|

781人浏览过

|

来源于php中文网

原创

VSCode不能直接调试UE C++项目,因其不支持UE调试协议和符号加载机制,无法识别UE_BUILD_DEVELOPMENT宏、解析.target.cs参数或连接UBT构建流程;正确跳转依赖compile_commands.json,调试需用Visual Studio。

vscode如何配置unreal engine(ue)开发环境

vscode 能不能直接调试 UE C++ 项目

不能,vscode 本身不支持 UE 的调试协议和符号加载机制。它没法像 Visual Studio 那样自动识别 UE_BUILD_DEVELOPMENT 宏、解析 .target.cs 生成的编译参数,更无法连接 UE 的 UnrealBuildTool(UBT)构建流程。强行配成“能跳转”不等于“能断点调试”,很多开发者卡在这一步后以为环境配好了,结果改完代码按 F5 直接报错或断点全灰。

让 vscode 正确跳转 UE 头文件和类定义

核心是复用 UE 生成的 compile_commands.json,而不是手动写 c_cpp_properties.json。UE 5.3+ 默认在生成解决方案时输出该文件(需开启),旧版本要加参数。

VSCode
VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载
  • 确保用 GenerateProjectFiles.bat(Windows)或 GenerateProjectFiles.sh(Linux/macOS)生成时带 -makecsharpprojectfiles 和 -createreleaseversion(可选),但关键是要有 -gencompilecommandsjson
  • 生成后检查项目根目录下是否有 Intermediate/Build/Win64/YourGame/Development/compile_commands.json(路径随平台和配置变化)
  • 在 vscode 中安装 C/C++ 扩展(Microsoft 官方),打开项目根目录,在设置里把 configurations 清空,只留 "compileCommands": "./Intermediate/Build/Win64/YourGame/Development/compile_commands.json"
  • 别碰 intelliSenseMode:UE 用的是 MSVC 工具链,即使你在 Windows 上用 clang-cl,也要设为 msvc-x64,否则宏展开和类型推导会错乱

修改代码后怎么快速编译并热重载

vscode 不参与 UE 构建,所以“保存即编译”是伪需求。真正高效的做法是把构建命令绑定到快捷键,绕过 VS 界面干扰。

  • 在 vscode 中按 Ctrl+Shift+P → 输入 Tasks: Configure Task → 选择 Create tasks.json file from template → 选 Others
  • 写一个调用 UnrealBuildTool.exe 的 task,例如:
    {
      "version": "2.0.0",
      "tasks": [
        {
          "label": "Build Game Editor",
          "type": "shell",
          "command": "${env:UE_ENGINE_ROOT}\Build\BatchFiles\RunUAT.bat",
          "args": [
            "BuildCookRun",
            "-project=${workspaceFolder}\YourGame.uproject",
            "-noP4",
            "-platform=Win64",
            "-clientconfig=Development",
            "-serverconfig=Development",
            "-build"
          ],
          "group": "build",
          "presentation": {
            "echo": true,
            "reveal": "always",
            "focus": false,
            "panel": "shared",
            "showReuseMessage": true,
            "clear": true
          }
        }
      ]
    }
  • 更轻量的替代:直接用 UBT 编译模块,比如:UnrealBuildTool.exe YourGame Win64 Development -project="${workspaceFolder}\YourGame.uproject" —— 这比完整 BuildCookRun 快得多,适合日常改 C++ 后验证
  • 注意:热重载(Hot Reload)只对非构造函数、非蓝图暴露函数生效;如果改了 AActor 子类的构造函数或 UCLASS() 宏,必须重启编辑器

为什么 Intellisense 总标红 UObject 或 UPROPERTY

不是头文件没包含,而是 __declspec(dllimport) 展开失败 + 宏嵌套太深,clangd 或 Microsoft C/C++ 扩展在解析 UE 的 CoreMinimal.h 时容易丢上下文。

  • 确认 compile_commands.json 里每个 entry 的 command 字段是否含完整 include 路径,特别是 -I"$(EngineDir)/Source/Runtime/Core/Public" 类似项 —— 如果路径里有空格或反斜杠没转义,vscode 就读不到
  • 在 c_cpp_properties.json 的 defines 里硬补上关键宏:"WITH_EDITOR=1"、"UE_BUILD_DEVELOPMENT=1"、"WIN32=1"、"PLATFORM_WINDOWS=1",缺一不可
  • 禁用 clangd:UE 的模板元编程和宏重度依赖 MSVC 行为,用 clangd 做 LSP 会导致 70% 的 UPROPERTY 标红,老老实实用 Microsoft 的 C/C++ 扩展
  • 如果仍标红,右键出问题的行 → Disable Error Squiggles,这不是妥协,是 UE 头文件设计决定的——Intellisense 本质是静态分析器,而 UE 的宏系统是运行时行为前置到编译期的产物
UE 的构建和编辑器耦合太深,vscode 只能做“高级文本编辑器 + 轻量构建触发器”。真要调用堆栈、内存视图、蓝图与 C++ 混合断点,还是得切回 Visual Studio。别在 launch.json 里折腾 UE 的调试器集成,那块儿根本没开放文档。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2155

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3342

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1116

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3819

2025.09.10

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2155

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3342

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1116

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

3819

2025.09.10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

0

2026.10.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn