如何通过clang-format将源文件对应头文件置于包含列表顶部？

首先明确clang-format的IncludeIsMainRegex工作逻辑：它会把当前cpp文件的**基础文件名（不含扩展名）**替换正则里的$1，再去匹配头文件名称。你的问题核心是正则未正确适配「尖括号+带目录路径」的头文件格式。

通用动态匹配配置 #

直接将IncludeIsMainRegex设为以下值，即可适配任意目录下、与cpp同名的尖括号头文件：

IncludeIsMainRegex: '<.*\/$1\.(h|hpp|hh|hxx)'

• 规则拆解：
  • <.*\/：匹配尖括号开头的任意目录路径（直到最后一个斜杠）
  • $1：自动替换为当前cpp文件的基础文件名（比如MyFile.cpp对应MyFile）
  • \.(h|hpp|hh|hxx)：匹配项目中常用的头文件扩展名，可按需增减

配合分组排序的完整配置示例 #

要实现「同名头文件置顶 + 其余头文件分组排序」，需搭配IncludeBlocks: Regroup和合理的IncludeCategories，示例如下：

IncludeBlocks: Regroup
IncludeIsMainRegex: '<.*\/$1\.(h|hpp|hh)'
IncludeCategories:
  - Regex: '^<.*\/your-project\/'
    Priority: 1
  - Regex: '^<.*\/third-party\/'
    Priority: 2
  - Regex: '^<'
    Priority: 3

• 效果说明：
  1. 与cpp同名的尖括号头文件会被识别为「主头文件」，直接排在include列表最顶部
  2. 项目内部头文件、第三方库头文件、系统头文件会按优先级分组排序

之前配置无效的原因 #

你尝试的<.*$1>存在两个问题：

• 未匹配头文件扩展名，会误匹配到非头文件的同名文件
• 未处理目录路径的斜杠，当头文件带目录时，$1无法与路径后的文件名正确匹配

可行性确认 #

完全可行。clang-format的IncludeIsMainRegex原生支持$1动态替换和复杂正则匹配，只要正则逻辑适配项目的头文件命名/路径规则，就能实现通用的同名头文件置顶效果。

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