vscode 仅支持 ue c++ 项目的代码阅读、跳转和基础补全，需通过生成 compile_commands.json 并配置 clangd 实现正确识别；ue 默认不生成该文件，须用 unrealbuildtool.exe -projectfiles -project="yourgame.uproject" -gencompilecommandsjson 命令触发，路径须纯英文无空格符号；clangd 比 cpptools 更适配 ue 的 msvc 扩展语法与宏展开；ufunction 等宏无法被直接识别，因 clangd 不执行 uht 预处理，只能依赖 compile_commands.json 的静态快照，故需及时重新生成以保持智能提示有效。
VSCode 不能调试 UE C++ 项目，也不能参与构建；它只负责代码阅读、跳转和基础补全。想让它“认得”UE代码，核心就两件事：喂对 compile_commands.json，再让 clangd 正确加载它。
怎么生成有效的 compile_commands.json
UE 默认不生成这个文件，手动复制路径或瞎猜路径基本无效。必须用 UnrealBuildTool.exe 命令触发：
- 在项目根目录（即
YourGame.uproject所在目录）打开终端，运行：UnrealBuildTool.exe -projectfiles -project="YourGame.uproject" -game -engine -gencompilecommandsjson - 生成成功后，文件路径应为：
Intermediate/Build/Win64/YourGame/Development/compile_commands.json（Windows）或对应平台子目录（如Mac/.../compile_commands.json） - 路径含中文、空格、括号（如
(x64)）会导致clangd静默失败——项目根目录必须纯英文、无空格、无符号 - UE 5.3+ 可在
GenerateProjectFiles.bat中直接加-gencompilecommandsjson参数，旧版本必须显式加
为什么必须用 clangd 而不是 Microsoft 的 cpptools
cpptools 对 UE 大量使用的 MSVC 扩展语法（如 __declspec）、深度模板嵌套、宏展开（UCLASS、UFUNCTION）支持极弱，常卡死在 UObject 继承链解析上；clangd 基于真实 Clang AST，能更好复现 UBT 实际传参（如 -Xclang -fms-extensions），识别更稳。
- 安装官方
clangd插件（作者：llvm-vs-code-extensions） - 禁用
cpptools，避免冲突 -
.vscode/settings.json中只配"clangd.compileCommands"，例如："clangd.compileCommands": "./Intermediate/Build/Win64/YourGame/Development/compile_commands.json" - 不要碰
c_cpp_properties.json——clangd不读它；删掉或留空
UFUNCTION 不提示、跳不到？这不是配置问题，是机制限制
clangd 和 cpptools 都不会执行 UE 的 UHT（Unreal Header Tool）预处理。你在 .h 里写的 UFUNCTION(BlueprintCallable)，对编辑器来说就是“不存在”的函数——它只认 UHT 输出的 *.generated.h 文件里的展开体。
- 手动把
Intermediate/Build/Win64/YourGame/Development/Inc/YourModule/加进includePath没用（clangd不认includePath） - 正确做法是在
.vscode/settings.json中加："clangd.arguments": ["--compile-commands-dir=Intermediate/Build", "--background-index"] - 若仍不识别，可验证路径是否有效：
clangd --check=./Intermediate/Build/Win64/YourGame/Development/compile_commands.json - 别开
clangd.fallbackFlags，UE 的 include 路径太深，自动推导大概率漏掉Engine/Source/Runtime/Core/Public等关键头文件
真正难的不是配路径，而是接受 VSCode 在 UE 开发中只能做“高级阅读器”——它看不到 UHT 展开结果，也拿不到构建上下文。所有跳转和补全都建立在 compile_commands.json 的静态快照上，一旦你改了模块名、重命名类、或没重新生成该文件，智能提示就会立刻失效。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
