VSCode+CMake Tools项目中如何配置IntelliSense排除未编译源文件？

在使用CMake Tools和CMake Presets的VSCode项目中，不同预设对应不同平台，会包含不同的待编译源文件集合，但右键执行「Go to Definition」时，IntelliSense会列出所有文件中的符号定义，包括当前预设未纳入编译的文件。要解决这个问题，核心是让IntelliSense仅读取当前预设对应的编译数据库，具体步骤如下：

1. 给每个CMake Preset配置独立的构建目录 #

修改CMakePresets.json，为每个configurePresets条目添加binaryDir字段，确保不同预设的构建目录相互独立，这样每个预设的compile_commands.json（编译数据库）会生成在各自的目录中：

{
    "version": 3,
    "cmakeMinimumRequired": {
        "major": 3,
        "minor": 20,
        "patch": 0
    },
    "configurePresets": [
        {
            "name": "platform1",
            "cacheVariables": {
                "PLATFORM_NAME": "platform1"
            },
            "binaryDir": "${sourceDir}/build/${presetName}"
        },
        {
            "name": "platform2",
            "cacheVariables": {
                "PLATFORM_NAME": "platform2"
            },
            "binaryDir": "${sourceDir}/build/${presetName}"
        }
    ]
}

2. 配置VSCode设置，绑定IntelliSense到当前预设的编译数据库 #

在项目的.vscode/settings.json中添加以下配置（如果文件不存在则新建）：

{
    // 让CMake Tools使用当前预设对应的构建目录
    "cmake.buildDirectory": "${workspaceFolder}/build/${cmake.activeConfigurePresetName}",
    // 指定IntelliSense读取当前预设的编译数据库
    "C_Cpp.default.compileCommands": "${workspaceFolder}/build/${cmake.activeConfigurePresetName}/compile_commands.json",
    // 确保使用默认的IntelliSense引擎（避免使用Tag Parser，它会扫描所有文件）
    "C_Cpp.intelliSenseEngine": "Default"
}

3. 切换预设后更新配置 #

每次切换CMake Preset（执行CMake: Select Configure Preset）后，需要完成以下操作让IntelliSense同步：

• 执行CMake: Configure，生成当前预设的编译数据库
• 执行C/C++: Resolve Configuration（可通过命令面板调用），让C/C++扩展重新加载编译配置

验证效果 #

按照上述配置后，切换到platform1预设并完成配置，右键点击main.c中的platform_name选择「Go to Definition」，应该只会跳转到platform1.c中的定义，不会再出现platform2.c的选项。

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