VSCode不能调试UE5项目，仅支持代码阅读与跳转；核心是用UBT生成compile_commands.json，并配置clangd插件指向该文件，重启窗口生效。
VSCode 不能调试 UE5 C++ 项目，也**不参与构建流程**——它只负责代码阅读、跳转和基础补全。想让 VSCode “认得” UE5 的 C++ 代码，核心就一件事：喂给它准确的 CompileCommands.json，再让它知道生成文件在哪。
怎么生成有效的 CompileCommands.json
UE 默认不生成这个文件，手动配路径或瞎猜路径全是白忙。必须用 UBT 命令触发生成：
- 在项目根目录下打开终端（不是 UE 编辑器内），运行：
UnrealBuildTool.exe -projectfiles -project="YourGame.uproject" -game -engine -gencompilecommandsjson - 检查是否生成成功：路径应为
Intermediate/Build/Win64/YourGame/Development/compile_commands.json（Windows）或对应平台子目录；注意文件名是compile_commands.json，不是CompileCommands.json或CompileCommands.txt - 如果路径含中文、空格或符号（如
(x64)），clangd很可能静默失败——建议项目根路径纯英文、无空格、无括号 - UE 5.3+ 可在
GenerateProjectFiles.bat中加-gencompilecommandsjson参数自动包含；旧版本必须显式加
用 clangd 还是 Microsoft C/C++ 插件？
选 clangd。UE 大量使用 MSVC 扩展语法（如 __declspec）、模板嵌套和宏展开（UCLASS, UFUNCTION），cpptools 对这些支持弱，常卡在 UObject 继承链解析上；clangd 基于真实 Clang AST，配合 -Xclang -fms-extensions 等 UBT 实际传参，识别更稳。
- 安装
clangd插件（官方，作者: llvm-vs-code-extensions） - 在
.vscode/settings.json中指定编译数据库位置："clangd.compileCommands": "./Intermediate/Build/Win64/YourGame/Development/compile_commands.json" - 别碰
c_cpp_properties.json——clangd不读它；删掉或留空，避免干扰 - 确保
clangd启动时能读到 UE 的 Windows SDK 和 MSVC 工具链路径（通常自动探测，若报错可查clangd输出面板）
为什么 UFUNCTION 不提示、跳不到？
因为 clangd 和 cpptools 都不执行 UHT（Unreal Header Tool）预处理。你在 .h 里写的 UFUNCTION(BlueprintCallable)，对编辑器来说就是“不存在”的函数——它只认 UHT 输出的 *.generated.h 文件里的展开体。
立即学习“C++免费学习笔记（深入）”；
- 手动把
Intermediate/Build/Win64/YourGame/Development/Inc/YourModule/加进 include 路径没用（clangd不认includePath） - 正确做法：在
.vscode/settings.json中加："clangd.arguments": ["--header-insertion=never", "-j=4"]，并确保compile_commands.json里已包含-I指向Inc目录的条目（UBT 生成时默认包含） - 想看某个
UFUNCTION的真实签名？直接在 VSCode 里按 Ctrl+Click，它会跳转到对应的YourClass.generated.h—— 那才是实际编译用的声明 - BlueprintCallable 函数在 VSCode 里不显示蓝图侧参数名（如
bool bPlaySound），这是正常现象，UHT 生成逻辑不在 LSP 感知范围内
改完代码后怎么编译？
VSCode 不编译 UE 项目。你写的 C++ 修改，必须由 UnrealBuildTool（UBT）编译，而 UBT 只响应 Visual Studio 或命令行调用。
- 别试图配 launch.json 调试 UE 进程——VSCode 无法加载 UE 符号、识别
UE_BUILD_DEVELOPMENT宏、或对接 UBT 构建参数 - 高效做法：在 VSCode 里配一个 task，一键调用 UBT：
"command": "${env:UE_ENGINE_ROOT}\Build\BatchFiles\RunUAT.bat"，args 传BuildCookRun或直接调UnrealBuildTool.exe YourGame Win64 Development -project="${workspaceFolder}\YourGame.uproject" - 热重载（Hot Reload）仍需在 UE 编辑器中触发；VSCode 只负责让你写得清楚、跳得准
最容易被忽略的是：生成 compile_commands.json 后，必须重启 VSCode 或重载窗口（Ctrl+Shift+P → Developer: Reload Window），否则 clangd 不会重新索引。还有，每次切换 UE 构建配置（Development → DebugGame），都要重新生成该 JSON 文件——路径变了，旧的立刻失效。
