electron/docs-translations/zh-CN/development/clang-format.md

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

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

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

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

根据 Electron C++ 代码样式自动格式化文件, 只要运行 clang-format -i path/to/electron/file.cc 即可. 它应该能够在 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 直接集成到您喜欢的编辑器中, 有关设置编辑器集成的更多指导，请参阅这些页面:

• Atom
• Vim & Emacs