Clang is a front-end compiler for C, C and Objective C. It's a liberally licensed open-source project backed by Apple, which uses it for its own tools.
clang-format
is a tool toautomatically format C/C++/Objective-C code, so that developers don't need toworry about style issues during code reviews.
It is highly recommended to format your changed C++ code before opening pullrequests, which will save you and the reviewers' time.
You can install clang-format
and git-clang-format
vianpm install -g clang-format
.
To automatically format a file according to Electron C++ code style, runclang-format -i path/to/electron/file.cc
. It should work on macOS/Linux/Windows.
The workflow to format your changed code:
git add your_changed_file.cc
.git-clang-format
, and you will probably see modifications inyour_changed_file.cc
, these modifications are generated from clang-format
.git add your_changed_file.cc
, and commit your change.If you want to format the changed code on your latest git commit (HEAD), you canrun git-clang-format HEAD~1
. See git-clang-format -h
for more details.
You can also integrate clang-format
directly into your favorite editors.For further guidance on setting up editor integration, see these pages: