美化源代码

美化代码意味着将对源代码文件应用缩进和样式。使用实验性的美化插件使用以下外部工具格式化您的源代码

• 艺术风格
• ClangFormat
• Uncrustify

美化插件将源代码解析为组件结构，例如赋值语句、if 块、循环等，并根据美化偏好设置格式化它们。您可以使用预定义的样式或定义自己的样式。

当您保存文件时自动格式化

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

   注意：您可能必须从源代码构建某些平台上的工具。

2. 启用美化插件。

   注意：自 Qt Creator 10.0.0 版起，ClangFormat 插件默认启用。转到 偏好设置 > C++ > 格式化模式，选择 禁用 来关闭 ClangFormat，因为启用美化插件时，它们可能产生意外的结果。

3. 转到 偏好设置 > 美化 > 一般，以选择要使用的工具。

   

4. 选择 文件保存时自动格式化 以在您使用“工具”字段中选择的工具保存文件时自动美化文件。
5. 转到 艺术风格、ClangFormat 或 Uncrustify 以设置工具的可执行文件路径和选择定义要使用样式的配置文件。

   

   美化 Uncrustify 偏好

格式化当前打开的文件

转到 工具 > 美化 > 艺术风格、ClangFormat 或 Uncrustify 以选择对当前文件中文本进行格式化的操作。

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

转到 格式化当前文件 以格式化当前打开的文件。

使用 ClangFormat 在光标处格式化

未选择文本时，请转到工具 > 美化器 > ClangFormat > 光标位置格式化以对光标下的句法实体进行格式化。

请转到格式化行以格式化所选行。

请转到取消选中文本的格式化以将选中行包裹在// clang-format off和// clang-format on之间。

使用Uncrustify格式化所选文本

未选择文本时，请转到工具 > 美化器 > Uncrustify > 格式化所选文本默认格式化整个文件。

要关闭此行为，请转到首选项 > 美化器 > Uncrustify，并清除未选择文本时格式化整个文件。