必须手动启用Beautifier插件：点击“帮助→关于插件”，在C++分类下勾选Beautifier，重启Qt Creator后进入“工具→选项→Beautifier”配置；需指定clang-format.exe路径，并可设置保存时自动格式化或自定义风格。
Ctrl+I 只能调用 Qt Creator 内置的缩进格式化，不改大括号位置、运算符空格、函数参数换行等——它不是真正的代码风格统一工具，只是“视觉对齐”。
真正要让 C++ 代码符合团队规范（比如 Google 风格或自定义规则），必须启用 Beautifier 插件并搭配外部格式化器，比如 clang-format。
怎么启用 Beautifier 插件？
Qt Creator 不默认开启这个功能，得手动勾选：
- 点击菜单 帮助 > 关于插件
- 在 C++ 分类里找到
Beautifier，打钩 - 点 立即重新启动 ——不重启插件不会加载
重启后，工具 > 选项 > Beautifier 就会出现。如果没看到，说明插件没生效或版本太旧（Qt Creator 4.6+ 才稳定支持）。
为什么 clang-format.exe 找不到或报错？
Beautifier 本身不带格式化引擎，它只是个“调度器”，必须指定一个可执行文件路径。常见问题：
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
clang-format.exe没下载：去 LLVM 官网 下对应系统的预编译包，解压后找到bin/clang-format.exe - 路径填错：Windows 上别用中文路径或带空格的路径（比如
C:\Program Files\...），建议移到C:\llvm\bin\clang-format.exe这类干净路径 - 权限问题：某些杀毒软件会拦截
clang-format.exe启动，临时禁用试试 - Qt Creator 版本太老：Qt Creator 12 以下对
clang-format的参数传递支持不稳定，推荐用 Qt Creator 14+（2025 年起主流版本）
如何让保存时自动格式化？
勾选 Enable auto format on file save 是最省事的方式，但要注意几个隐性行为：
- 只对当前编辑器打开的、且语法识别为 C++ 的文件生效（
.cpp、.h），.qrc或.ui不会触发 - 格式化发生在“写入磁盘前”，所以如果
.clang-format文件缺失或语法错误，会静默失败（不会弹窗报错，但代码没变） - 若同时启用了
ClangFormat和Artistic Style，只有当前选中的那个工具生效 - 快捷键
Ctrl+I此时仍可用，但它走的是内置缩进逻辑，和 Beautifier 无关；真正生效的是你设的 Beautifier 快捷键（比如Ctrl+Alt+K）
自定义 clang-format 风格怎么生效？
直接在 Beautifier > Clang Format > Use customized style > Add 里粘贴配置，容易漏掉两个关键点：
-
Language: Cpp必须写在第一行，否则 Qt Creator 会忽略整个块 - 像
AlignAfterOpenBracket: DontAlign这种值，大小写敏感，DontAlign不能写成dontalign或DONT_ALIGN - 如果想项目级生效（而不是全局），把
.clang-format文件放在项目根目录，然后 Beautifier 的 Style 选File——这时 Qt Creator 会优先读这个文件，而非插件里配的样式
注意：.clang-format 文件名必须带点，且不能是 _clang-format（Qt Creator 14.0 默认只认 .clang-format）。
