如何正确配置clang-format禁用include头文件排序功能？

原因说明 #

并非官方文档存在错误，而是你查看的是最新版clang-format文档，和你正在使用的10.0.0版本特性不匹配，SortIncludes配置项的类型在版本迭代中发生过变更：

• clang-format 13及更早版本：SortIncludes为布尔类型，仅支持true（启用头文件排序）、false（禁用头文件排序）两个取值
• clang-format 14及更高版本：SortIncludes调整为枚举类型，取值改为Never（禁用排序）、CaseSensitive（大小写敏感排序）、CaseInsensitive（大小写不敏感排序）

你使用的clang-format 10属于13以下的旧版本，无法识别枚举值Never，因此会抛出YAML格式错误。

正确禁用方案 #

根据你使用的clang-format版本选择对应配置即可：

• 若继续使用clang-format 10（13及以下版本通用），在配置文件中写入：

SortIncludes: false

• 若后续升级到clang-format 14及以上版本，替换为如下配置即可：

SortIncludes: Never

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