PerfettoSQL 样式指南

本页面提供了编写 PerfettoSQL 的建议样式指南，该指南在 trace processor 的 PerfettoSQL 标准库中使用。它还提供了关于自动格式化程序的指导。

规则

1. 保持行长度在 80 个字符以下
2. 函数名、宏名和表/视图名都应使用小写 snake_case
3. SQL 关键字都应使用大写
4. 换行 SQL 表达式时，将连接关键字（AND/OR）放在_下一行的开头_，而不是_上一行的末尾_

自动格式化程序

PerfettoSQL 带有一个自动格式化程序，由 tools/format_sql.py Python 脚本实现。这是一个简单的脚本，可以对任何文件或目录运行，并自动格式化代码以遵守上述规则。

在向标准库贡献时，必须运行此脚本。它在运行 tools/gen_all 时自动执行，这是 Perfetto 标准开发工作流程的一部分。预提交检查将确保你已完成此操作。

自动格式化程序并不完美，经常有一些微妙的边缘情况：

1. 它不处理复杂表达式中间的注释。最好将这些注释放在这些表达式的开头，而不是中间。
2. 它不格式化宏调用，因为它们在许多情况下具有非常复杂的语义。