Clang 格式化

功能

Clang-format 是一个基于 LLVM 的 C++ 代码格式化工具。本包允许您在 Sublime Text 中轻松运行它。

关于

在这个包中，我们提供了一个用于 Sublime Text 3 的 Clang-format 的替代封装。虽然 LLVM 提供了一个简单的插件来与 Sublime Text 一起使用，但在这里可以找到，但它并没有充分利用任何 Sublime Text 软件包的功能。我们添加了新功能，例如从设置文件中自定义样式、使用命令面板选择样式，以及更简单的安装方式。

安装

• 以下方式之一安装 clang-format：
  • 使用您的软件包管理器进行安装，例如 sudo apt-get install clang-format 或 sudo apt-get install clang-format-5.0。
  • 下载完整的 LLVM 工具链 并提取 clang-format 二进制文件。仅提取 .tar.xz 文件并将 bin/clang-format 复制到您的 PATH 中（例如 /usr/local/bin）。
• 通过 Package Control 以通常方式安装此包。
• 设置 clang-format 二进制文件的路径。您可以在 Sublime Text 中通过选择命令面板中的 Clang Format - Set Path 来完成此操作。提示：路径应如下所示 [path/to/clang]/clang/bin/clang-format。如果 clang-format 在您的系统路径中，则不需要进行任何操作。

使用

• 默认快捷键是OSX上的 super+option+a 以及其他环境中的 option+cmd+a。这将应用 clang-format 到所选内容。
• 从命令面板，您可以使用 Clang 格式：选择样式 来选择格式类型。您会发现一些默认设置，还有一个新的“自定义”条目。选择此条目允许您通过设置文件自定义样式。您可以从主菜单中的 包设置 访问它。在此文件中，您可以添加自定义规则，例如 Allmen 风格的花括号，以及不同的缩进。有关示例，请参阅 http://clang.llvm.org/docs/ClangFormatStyleOptions.html。
• 通过 Sublime Text 预设可以访问“自定义”格式和其他设置。
• 可以在将格式化程序运行于每次保存文件时，将设置更改为 "format_on_save": true。
• 要按包的基础改变设置，在 ClangFormat 键下添加它们，例如项目.sublime-settings。

{
  "folders": [],
  "settings": {
    "ClangFormat": {
      "format_on_save": true
    }
  }
}

如果您喜欢这个

• … 并且愿意做出贡献，欢迎提供拉取请求（PR）！

• 或许您会喜欢我的另一个插件，iOpener。它允许您通过路径打开文件，带有完成功能、历史记录和其他实用功能。

• 否则，为何不顺便访问 GitHub 并为这个仓库加星标呢？

致谢

感谢 LLVM 项目进行了艰苦的工作，包括编写 clang format，以及这个包所基于的原始 Sublime Text 插件。

也感谢 y0ssar1an、Bendtherules 以及其他贡献者对它们的改进！

最后

为何不去看看让我对手动格式的赞助档产生兴趣的视频呢？

C++ 龙的呵护与滋养