如何基于CMake变体在VS Code中自动排除特定文件/文件夹

这个需求完全可行，核心是利用VS Code的变量替换机制，结合CMake Tools暴露的当前变体变量，动态配置files.exclude规则，实现选中某变体时自动隐藏其他变体的专属文件。

具体实现步骤 #

1. 确认cmake-variants.json的变体命名 #

确保你的cmake-variants.json中每个变体都有清晰的name字段，示例配置如下：

{
  "variants": [
    {
      "name": "VariantA",
      "buildType": "Debug",
      "description": "变体A的Debug构建"
    },
    {
      "name": "VariantB",
      "buildType": "Release",
      "description": "变体B的Release构建"
    },
    {
      "name": "VariantC",
      "buildType": "RelWithDebInfo",
      "description": "变体C的带调试信息的Release构建"
    },
    {
      "name": "VariantD",
      "buildType": "MinSizeRel",
      "description": "变体D的最小尺寸构建"
    }
  ]
}

2. 在settings.json中配置动态排除规则 #

VS Code支持使用CMake Tools提供的${cmake.buildVariant}变量，结合条件表达式动态控制files.exclude。根据你的专属文件结构选择对应配置：

场景1：专属文件按变体文件夹存放

如果每个变体的专属文件都放在独立文件夹（比如src/VariantA/、src/VariantB/等），配置如下：

{
  "files.exclude": {
    "src/VariantA/**": "${cmake.buildVariant} != 'VariantA'",
    "src/VariantB/**": "${cmake.buildVariant} != 'VariantB'",
    "src/VariantC/**": "${cmake.buildVariant} != 'VariantC'",
    "src/VariantD/**": "${cmake.buildVariant} != 'VariantD'"
  }
}

场景2：专属文件是单个独立文件

如果每个变体对应单个专属文件（比如src/variant_a.c、src/variant_b.c等），配置如下：

{
  "files.exclude": {
    "src/variant_a.c": "${cmake.buildVariant} != 'VariantA'",
    "src/variant_b.c": "${cmake.buildVariant} != 'VariantB'",
    "src/variant_c.c": "${cmake.buildVariant} != 'VariantC'",
    "src/variant_d.c": "${cmake.buildVariant} != 'VariantD'"
  }
}

3. 验证效果 #

切换CMake变体后，VS Code会自动更新${cmake.buildVariant}的值，对应的非当前变体的专属文件/文件夹会被自动排除，不会出现在文件浏览和搜索结果中。

注意事项 #

• 确保CMake Tools插件已正确激活，变体切换后需等待1-2秒让VS Code完成变量刷新。
• 变体名称的字符串匹配要完全一致，注意大小写和特殊字符。
• 若使用glob匹配规则，需避免误排除Common文件夹内的共享文件。

内容的提问来源于stack exchange，提问作者Basly Med Hedi