使用CMake+clangd+MSVC+VSCode时无法正常启用C++23支持

一、CMake与clangd对C++23的支持情况 #

• CMake 3.20及以上版本正式支持CXX_STANDARD 23，最新版本完全兼容C++23标准配置；
• clangd 14.x及以后版本已支持C23，最新版本对C23特性的支持覆盖度很高。

二、问题根源 #

1. CMake生成-std:c++latest的原因：
   在MSVC环境下，CMake默认将CXX_STANDARD 23映射为-std:c++latest——这是因为MSVC早期对C++23的支持是通过latest开关推进的，CMake的MSVC工具链逻辑沿用了这一行为，而非直接生成-std:c++23。
2. 宏值异常的核心原因：
   MSVC默认不会更新__cplusplus和_MSVC_LANG的数值到对应标准版本，必须额外添加/Zc:__cplusplus编译选项，才能让这两个宏正确反映当前使用的C标准。你能正常编译C23特性是因为-std:c++latest已经启用了相关特性，但宏未被正确触发更新。
3. 手动修改compile_commands.json无效的原因：
   clangd会自动监听CMake生成的构建文件，后续CMake重新生成时会覆盖你的手动修改；另外，仅修改-std开关而未添加/Zc:__cplusplus，宏值仍不会正确更新。

三、解决方案 #

1. 修改CMake配置，强制生成正确的编译选项 #

在CMakeLists.txt中添加以下配置：

# 设置C++23标准
set(CMAKE_CXX_STANDARD 23)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

# 针对MSVC添加必要选项
if(MSVC)
  # 让__cplusplus和_MSVC_LANG宏正确反映标准版本
  add_compile_options(/Zc:__cplusplus)
  # 强制替换为-std:c++23，覆盖默认的-std:c++latest
  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std:c++23")
endif()

2. 让clangd正确识别配置 #

• 确保VSCode的clangd扩展已启用，在VSCode设置中确认clangd.arguments包含--compile-commands-dir=${workspaceFolder}/build（路径根据你的CMake构建目录调整）；
• 重新运行CMake生成构建文件，然后通过VSCode命令面板执行clangd: Restart Language Server重启服务。

四、验证方式 #

在源文件中添加以下代码，查看clangd的提示或编译运行结果：

#include <iostream>

int main() {
    std::cout << "__cplusplus: " << __cplusplus << "\n";
    std::cout << "_MSVC_LANG: " << _MSVC_LANG << "\n";
    return 0;
}

配置正确的话，__cplusplus会显示202100L（C++23对应的标准宏值），_MSVC_LANG也会显示对应版本的数值。

内容的提问来源于stack exchange，提问作者BH2WFR