VSCode 的宏悬停依赖 C/C++ 扩展的语言服务器，失效主因是配置缺失：需确保 c_cpp_properties.json 中正确配置 defines、includePath，并启用 Default IntelliSense 引擎，再重置索引即可恢复。
VSCode 本身不支持“自定义宏定义悬停”——它没有宏定义解析能力，悬停显示的宏内容完全依赖 C/C++ 扩展的语言服务器（如 Microsoft C/C++）是否能正确识别并展开你项目中定义的宏。所谓“宏悬停没内容”，90% 是配置缺失或语言服务未就绪，不是功能关不关的问题。
为什么 #define 悬停只显示 raw 文本或 “no definition found”
常见错误现象包括：光标悬停在 MAX_SIZE 上，只看到 #define MAX_SIZE 1024 一行，没有跳转、无参数提示、无引用位置；或直接空白。这不是悬停被禁用，而是 LSP 无法把宏和它的展开上下文关联起来：
- 项目根目录下缺少
c_cpp_properties.json，或其中"defines"字段没写你实际用的宏（比如"MY_DEBUG"、"TARGET_ARM"） -
c_cpp_properties.json里"configurationProvider"被设为"ms-vscode.cmake-tools"等非默认值，但对应插件未启用或未完成配置 - 宏定义在头文件里，但该头文件没被
#include进当前打开的源文件，或包含路径（"includePath"）漏配 - 用了构建系统宏（如 CMake 的
add_definitions(-DRELEASE)），但没通过"compileCommands"或"browse.path"让 C/C++ 扩展感知到
怎么快速确认并补全宏定义配置
别翻文档猜路径，直接用 VSCode 内置流程生成合规配置：
- 确保已安装官方
C/C++扩展（id:ms-vscode.cpptools） - 打开一个
.c或.cpp文件，按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入C/C++: Edit Configurations (JSON)回车 - 如果提示“生成新配置”，选
Linux/Mac/Win32（按你当前开发环境），它会自动创建.vscode/c_cpp_properties.json - 在生成的
"configurations"数组里，找到你当前使用的配置（通常"name": "Linux"），往里面加"defines"和"includePath"，例如：
[
{
"name": "Linux",
"includePath": ["${workspaceFolder}/**", "/usr/include/c++/11/**"],
"defines": ["DEBUG", "ENABLE_LOG=1", "PLATFORM_LINUX"],
"compilerPath": "/usr/bin/gcc"
}
]
保存后，等右下角状态栏不再显示 Processing...（通常 2–5 秒），再试悬停 —— 宏名现在应能展开并显示定义来源。
宏悬停失效时最该先查的三个地方
不用重启、不用重装，三步定位根源：
- 看右下角语言模式：必须是
C或C++，不是Plain Text或C_CPP（这是旧版错误名称）；点它可手动切换 - 打开命令面板，输入
C/C++: Toggle IntelliSense Engine，确保用的是Default（即clangd或Microsoft引擎），别选Tag Parser（它不支持宏语义） - 按
Ctrl+Shift+P→ 输入C/C++: Reset IntelliSense Database，强制重建索引（尤其改过defines后必做）
真正难的从来不是加几行 JSON，而是让语言服务器知道“哪些宏该算进当前文件的上下文”。一旦 c_cpp_properties.json 里的 defines 和 includePath 与真实构建逻辑对不上，悬停就永远只能看到字面量——它不是没努力，是根本没拿到有效信息。
