Uses clang-format
from Clang 10
...or install with Homebrew: brew install --cask xcodeclangformat
This plugin is written for Xcode 8's new plugin infrastructure and compatible through at least Xcode 11.4 It uses Clang's libclangFormat
library to format code according to a .clang-format
file.
Open the app, select a predefined style, or open the .clang-format
file from your project:
Then, use the Format Source Code command in Xcode's Editor menu:
Due to macOS sandboxing restrictions, this plugin behaves slightly differently compared to the command line clang-format
command: It always uses the style selected in the configuration app, and will not use the nearest .clang-format
file on disk.
Download the precompiled app or build it yourself, then open the app. You might have to right click on the app bundle, and choose Open to run non-codesigned applications. Then,
- On OS X 10.11, you'll need to run
sudo /usr/libexec/xpccachectl
, then reboot to enable app extensions. - On macOS Sierra and later, extensions should be loaded by default.
Then, go to System Preferences → Extensions, and make sure that clang-format in the Xcode Source Editor section is checked:
To define a keyboard shortcut, open Xcode's preferences, and switch to the Key Bindings tab. Duplicate the default key binding set if you don't have your own set already. Search for clang-format
, then add your preferred key bindings for Format Selection
or Format Entire File
.
To build XcodeClangFormat, run ./configure
on the command line, then build the XcodeClangFormat scheme in the included Xcode project.
Xcode code formatting extensions are severely limited and don't have access to the file system. They also don't get to know the file name of the file to be changed, so there's no way for this extension to load the correct file.
The Xcode extension mechanism doesn't allow that; the only thing you can do is return the altered source code.
If you're using macOS Sierra, please follow the installing guide. on OS X 10.11, I haven't found a way to make this extension work besides manually building it.
If the menu items randomly disappears, quit Xcode. In Finder, rename Xcode.app
to something else, then rename it back to Xcode.app
. 🤯
Make sure that you're running ./configure
in the root folder. This downloads and unpacks the precompiled libraries and headers from the llvm.org that are required for compiling.