在 C++ 代码中使用 clang-format 工具

clang-format是一个自动格式化 C/C++/Objective-C 代码的工具, 可以让开发人员不需要担心代码审查期间的样式问题.

强烈建议在发起请求之前格式化已更改的 C++ 代码,这将节省您和审阅者的时间.

你可以通过 npm install -g clang-format 安装 clang-formatgit-clang-format.

To automatically format a file according to Electron C++ code style, run clang-format -i path/to/electron/file.cc. It should work on macOS/Linux/Windows.

格式化已更改代码的工作流:

  1. 在 Electron 存储库中更改代码.
  2. 运行 git add your_changed_file.cc.
  3. 运行 git-clang-format, 然后你将可能会看到修改后的 your_changed_file.cc, 这些修改是从 clang-format 生成的.
  4. 运行 git add your_changed_file.cc, 并提交你的修改.
  5. 现在准备好的分支推送请求已经被打开.

如果你想在你最新的 git commit(HEAD) 中格式化更改的代码, 你可以运行 git-clang-format HEAD~1. 通过 git-clang-format -h 可以获得更多详情.

编辑器集成

您还可以将 clang-format 直接集成到您喜欢的编辑器中, 有关设置编辑器集成的更多指导,请参阅这些页面: