VSCode的C++内联提示（如形参名）不原生支持，必须依赖clangd语言服务器；需禁用cpptools、安装clangd、生成compile_commands.json、启用Clangd: Inlay Hints相关选项且clangd版本≥14。
VSCode 的 C++ Inlay Hints 依赖 clangd，不是原生支持
VSCode 自身对 C++ 的内联提示（比如函数调用时显示 paramName:）完全交给语言服务器处理。官方 C/C++ 扩展（ms-vscode.cpptools）不支持 inlay hints；必须切换到 clangd 才能开启形参名提示。
这意味着：你得卸载或禁用 cpptools，安装 clangd 插件，并确保项目有正确的 compile_commands.json 或 compile_flags.txt。
- 不生成编译数据库 →
clangd无法推导类型和参数名 → 提示全失效 - 用了 CMake？推荐用
cmake-tools扩展 +CMakeLists.txt配置好构建类型后，勾选 “Generate compile commands” - 手动编译的项目？在项目根目录运行：
bear --make或intercept-build make生成compile_commands.json
启用 inlayHints 参数并确认 clangd 版本 ≥14
clangd 默认关闭形参提示，需显式开启；且旧版本（如 12/13）不支持 inlayHints 功能，强行配置无反应。
在 VSCode 设置中搜索 “clangd inlay”，找到 Clangd: Inlay Hints，勾选以下三项：
立即学习“C++免费学习笔记（深入）”；
Clangd: Inlay Hints → Enabled-
Clangd: Inlay Hints → Parameters（控制形参名，如value:） -
Clangd: Inlay Hints → Type Hints（可选，显示变量类型，如: int）
验证版本：终端运行 clangd --version，输出应含 version 14. 或更高。macOS 用户若用 Homebrew 安装，执行：brew install llvm（新版 brew 默认装 16+），然后在 VSCode 设置里指定 Clangd: Path 为 /opt/homebrew/opt/llvm/bin/clangd（Apple Silicon）或 /usr/local/opt/llvm/bin/clangd（Intel）。
常见失效场景与绕过技巧
即使配置正确，以下情况仍不会显示形参提示：
- 函数调用是宏展开结果（如
LOG(INFO) ）→ <code>clangd不解析宏体内的调用上下文 - 参数是模板推导类型且未显式标注（如
foo(auto x)或foo(x)调用时x类型模糊）→ 提示被抑制 - 头文件未被
clangd索引（比如路径不在compile_commands.json的directory下）→ 检查 JSON 里每条命令的directory是否为绝对路径、是否包含所有头搜索路径 - VSCode 窗口打开的是子目录而非项目根目录 →
clangd找不到compile_commands.json→ 始终在项目最外层目录打开 VSCode
临时调试：在代码中加一行 // clangd-inlay-hint-test，保存后看状态栏是否出现 clangd 正在索引提示 —— 没反应说明服务根本没起来。
Windows 上 MSVC 工具链要额外处理
用 Visual Studio 的 cl.exe 编译时，clangd 默认不认识 MSVC 内置宏和头路径，导致无法解析标准库类型（如 std::string），进而抑制所有 inlay hints。
解决方法是在项目根目录放一个 compile_flags.txt，内容为：
–x c++ –std=c++17 –I"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\include" –I"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Tools\MSVC\14.36.32532\atlmfc\include" –I"C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\VS\include" –D_CRT_SECURE_NO_WARNINGS
注意：14.36.32532 替换为你本地 MSVC 版本号，路径可通过 VS Installer 查看；compile_flags.txt 优先级低于 compile_commands.json，如果已有 JSON 文件，需删掉或确保其命令里已带等效参数。
inlay hints 对编译器抽象层敏感，哪怕路径少一个反斜杠、宏定义漏一个，都可能让整个提示链断掉 —— 这是最容易卡住的地方。
