返回Qt.io
联系我们 博客 下载Qt

参考

C++代码风格

Qt Creator使用Clang LibFormat库来自动格式化和缩进C++代码。它对一个项目或整个组织的代码风格进行强制。

为C++编辑器指定全局缩进设置

  1. 转到 首选项 > C++。

    {Code Style preferences}

  2. 在 格式化模式 中，选择
    • 仅缩进 以仅缩进代码。
    • 完整格式化 以使用 Ctrl+I 键盘快捷键来格式化代码而不是缩进。
    • 使用内置缩进器 以关闭ClangFormat。
  3. 选择 忽略大于 以通过忽略大文件来加快解析速度。指定要解析的文件的最大大小。
  4. 要在你键入时应用格式，请选择 键入时格式化。
  5. 要在保存文件时应用格式到编辑的代码，请选择 在文件保存时格式化编辑的代码。
  6. 要为所有项目全局更改ClangFormat样式，请选择 使用自定义设置。
  7. 在 自定义设置 中，选择要更改的设置，然后选择 复制。
  8. 给设置命名，然后选择 确定。
  9. 在 ClangFormat 中，编辑 ClangFormat样式选项。实时预览显示首选项如何更改缩进。如果您输入无效值，则会看到警告消息。

使用内置缩进器

{Code Style preferences for built-in indenter}

如果您在 格式化模式 中选择 使用内置缩进器，则可以指定如何

  • 解释 制表符 和 退格 键盘按键。
  • 添加缩进器解释为不需要在结尾分号处声明宏。
  • 缩进类、函数、块和命名空间的内容。
  • 缩进类、命名空间、枚举、函数和块的花括号。
  • 控制switch语句及其内容。
  • 对续行进行对齐。
  • 将指针 (*) 和引用 (&) 绑定到类型和声明中的标识符、类型名称或左或右 const 或 volatile 关键字。

指定内容设置

您可以在类中缩进与它们相关的公共、受保护和私有语句和声明。

您还可以在函数和块内缩进语句，以及在命名空间内缩进声明。

{Content preferences}

指定花括号设置

您可以对类、命名空间、枚举和函数声明以及代码块进行缩进。

{Braces preferences}

指定开关语句设置

您可以在开关语句中缩进case或default语句，或相关语句或块。

{Switch preferences}

指定对齐

要将续行符对齐到赋值后的令牌，例如= 或 +=，请选择赋值后对齐。您可以在通用选项卡中指定对齐续行符的额外设置。

您还可以在条件语句中添加空格，以便它们不与下一行对齐。通常，这只会影响if语句。

{Alignment preferences}

绑定指针和引用

要将类型和声明中的指针（*）和引用（&）绑定到标识符、类型名称或左或右的const或volatile关键字，请选中指针和引用选项卡中的复选框。

* 和 & 字符将自动绑定到指向函数或数组的指针的标识符。

{Pointers and References preferences}

从命令行创建ClangFormat文件

您可以从命令行创建具有某些预定义样式的配置选项的 .clang-format 文件。例如，要创建LLVM样式的格式文件，请输入以下命令

clang-format -style=llvm -dump-config > .clang-format

另请参阅缩进文本或代码，指定代码样式，行为，Qt Quick 代码样式和Nim。

参考

©2024 Qt公司有限公司。此处包含的文档贡献是各自所有者的版权。此处提供的文档根据自由软件基金会发布的GNU自由文档许可版本1.3的条款进行许可。