Visual Studio 2019使用Clang格式化时的.clang-format报错及适配方案咨询

• 你遇到的未知配置键报错，本质是Visual Studio 2019 16.8.4内置的Clang-Format版本与你使用的配置文件的键位版本不匹配
• 16.8.4版本内置的Clang-Format基于LLVM 11.x开发，你提到的IndentCaseBlocks是LLVM 12.0版本才正式新增的配置项，旧版解析器自然会将其判定为无法识别的键
• 你提到的TabIndent、ColumnLimit这类可正常生效的配置，都是LLVM早期就确定的通用稳定键，不存在版本适配问题

不存在单独发布的VS专属.clang-format模板，VS内置的Clang-Format本身就附带了当前版本支持的所有配置项的完整基准集，直接生成即可100%规避未知键报错：

1. 找到VS安装目录下内置的clang-format可执行文件，默认路径参考（根据你的安装版本（社区/专业/企业版）调整路径前缀）：

   C:\Program Files (x86)\Microsoft Visual Studio\2019\你的版本\VC\Tools\Llvm\bin\clang-format.exe
   

2. 打开VS自带的“Developer Command Prompt for VS 2019”，执行以下命令，即可导出当前内置Clang版本支持的全部配置项（基于LLVM官方风格的全量配置）：

   clang-format --style=llvm --dump-config > .clang-format
   

3. 导出的文件中没有任何超出当前版本支持范围的配置键，是该环境下能用到的最全配置集合，所有调整都会被正常识别。

• 不要直接照搬网络上面向高版本Clang（LLVM12及以上）的配置文件，这类文件通常包含大量你当前环境无法识别的新键，比如IndentCaseBlocks、BreakBeforeAttributes、EmptyLineAfterAccessModifier等，导入后就会触发未知键错误
• 日常调整时优先选择跨版本稳定的通用配置项，比如IndentWidth、TabWidth、AccessModifierOffset、BreakBeforeBraces、ColumnLimit这类经过多版本迭代的成熟配置，不会出现兼容问题
• 如果必须使用高版本Clang-Format的新配置能力，可以在VS中手动指定自定义clang-format路径：打开「工具->选项->文本编辑器->C/C++->格式->ClangFormat」，勾选“使用自定义clang-format.exe”，选择你单独安装的高版本LLVM目录下的clang-format.exe，即可解锁对应版本的全部配置项

补充说明：基于导出的全量配置做小范围调整即可达到自定义格式的目的，完全不需要引入超出当前版本支持范围的配置键，就能满足绝大多数格式调整需求。

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