Clang-Format教程:如何指定自定义格式选项文件?
配置clang-format v6.0.0自定义样式(Windows 10 Pro 64位)
我来给你梳理下完整的配置流程,你已经顺利完成了基于LLVM样式生成基础配置文件这一步,接下来咱们把自定义样式的部分落地:
1. 回顾基础配置文件生成命令
你已经成功执行过这条命令,贴出来方便后续参考:
clang-format -style=llvm -dump-config > .clang-format
执行后当前目录会生成.clang-format文件,这就是咱们自定义样式的基础模板。
2. 自定义样式的两种实现方式
根据clang-format官方文档说明:
当所需代码格式样式与现有选项不同时,可通过-style="{key: value, ...}"选项或将样式配置放入.clang-form...来自定义样式。
方式一:命令行临时指定(适合单次调整)
如果只是临时用一次自定义格式,不用修改配置文件,直接在命令行通过-style参数传入键值对即可,比如:
clang-format -style="{IndentWidth: 4, TabWidth: 4, UseTab: Always}" your_source_code.cpp
这种方式不会影响全局配置,用完就恢复默认。
方式二:修改.clang-format配置文件(推荐长期使用)
要是需要固定项目的代码格式,直接编辑刚才生成的.clang-format文件,找到对应配置项修改值就行。举几个常见的调整例子:
- 把默认的
IndentWidth: 2改成IndentWidth: 4 - 将
UseTab: Never替换为UseTab: Always,用制表符替代空格缩进 - 把
ColumnLimit: 80调整为ColumnLimit: 120,放宽每行字符限制
修改完成后,后续执行格式化时不需要额外指定-style参数,clang-format会自动读取当前目录的.clang-format配置:
clang-format -i your_source_code.cpp
这里的-i参数会直接在原文件上应用格式化,不用手动替换内容,非常省心。
小提醒
- 要是记不清某个配置项的作用,直接在命令行输入
clang-format --help就能看到基础参数说明,不用额外查文档 - 把
.clang-format放在项目根目录,子目录下的所有文件都会自动继承这个样式配置
内容的提问来源于stack exchange,提问作者BenevolentDeity
相关产品推荐
相关产品推荐

