1. Qt Creator 集成

Qt Creator 本身自带的格式化功能非常有限,使用起来并不能满足我们的实际需求
因此,这里将 clang-format 集成到 Qt Creator

1.1 启用 Beautifier 插件

通过 Qt Creator 内置的 Beautifier 插件,可以使用外部强大的格式化工具来格式化代码
首先需要启用该插件,【帮助】菜单 -> 【关于插件…】,勾选选中 Beautifier插件(会提示重启生效),如下:
clang-20260126004456093

1.2 配置 clang-format

首先,打开【Preferences…】-> 【Beautifier】,可见支持 3 个外接的格式化工具:
clang-20260126004538463

然后,将格式化工具指定为ClangFormat
clang-20260126004558664

最后,打开【Clang Format】标签页,指定 clang-format 可执行程序的路径,并指定预定义风格,如下:
clang-20260126004619778

说明:
预定义风格指定为 File 表示使用 .clang-format 文件来格式化代码
如果在代码的当前目录以及父目录找不到 .clang-format,则使用 Fallback style 指定的风格

Qt Creator 也可以集成另外两个代码格式化工具:Artistic StyleUncrustify,基本和集成 clang-format 区别不大,不再赘述!

2. VSCode 集成

2.1 安装clang-format插件

首先,点击左侧插件图标,搜索 clang-format,安装插件,如下:
clang-20260126004648416

然后,设置插件,指定 clang-format 程序的路径,如下:
clang-20260126004707995

设置完毕后,其实就是在用户的 settings.json 中,增加了如下一行:
clang-20260126004726307

最后,将 .clang-format 文件拷贝到项目根目录,或者其上级目录。
在代码区域右键 -> “Format Document”, 或 Shift+Alt+F 快捷键,就可以格式化代码了,如下:
clang-20260126004746604

2.2 保存自动格式化

左下角小齿轮图标 -> “Settings”,打开设置界面搜索 “onSave”,勾选如下选项:
clang-20260126004807872

设置完毕后,其实就是在用户的 settings.json 中,增加了如下一行:
clang-20260126004829293

此时,保存代码时,会自动使用 clang-format 格式化代码!