美化源代码

美化代码是指对源代码文件应用缩进和样式。使用实验性的 Beautifier 插件，通过以下外部工具对源代码进行格式化：

• Artistic 样式
• ClangFormat
• Uncrustify

“美化器”插件会将源代码解析为组件结构（例如赋值语句、if 代码块、循环等），并根据“美化器”首选项对它们进行格式化。您可以使用预定义的样式，也可以自定义样式。

若要在保存文件时自动对其进行格式化：

1. 下载并安装用于格式化源代码的工具：
   • 艺术风格
   • ClangFormat
   • Uncrustify

   注意： 在某些平台上，您 可能需要从源代码编译这些工具。

2. 启用 Beautifier 插件。

   注意：自 Qt Creator 10.0.0起 ，ClangFormat插件默认处于启用状态。请前往Preferences >C++ >Formatting mode ，并选择Disable 以禁用ClangFormat——若同时启用Beautifier，两者结合可能会导致意外结果。

3. 请前往Preferences >Beautifier >General 选择要使用的工具。

   

4. 选择“Automatic formatting on file save ”，即可在使用“Tool ”字段中选定的工具保存文件时自动美化文件。

   若要在保存文件时临时禁用此设置，请转至“File ”，然后选择“Save Without Formatting ”。

5. 转到“Artistic Style ”、“ClangFormat ”或“Uncrustify ”，以设置工具可执行文件的路径，并选择定义要使用样式的配置文件。

   

   Beautifier Uncrustify 首选项

格式化当前打开的文件

转到Tools >Beautifier >Artistic Style 、ClangFormat 或Uncrustify ，以选择用于格式化当前文件中文本的操作。

您可以为这些操作创建键盘快捷键。

访问Format Current File 以格式化当前打开的文件。

使用 ClangFormat 对光标位置进行格式化

在未选中任何文本时，转至Tools >Beautifier >ClangFormat >Format at Cursor ，以格式化光标下方的语法实体。

访问Format Line(s) 以格式化所选行。

访问Disable Formatting for Selected Text ，将选中的行包裹在// clang-format off 和// clang-format on 中。

使用 Uncrustify 格式化选定文本

当未选中任何文本时，转至Tools >Beautifier >Uncrustify >Format Selected Text ，默认对整个文件进行格式化。

若要关闭此功能，请在Preferences >Beautifier >Uncrustify 中清除Format entire file if no text was selected 。