C/C++ language servers
The below was written for clangd, but much applies to cquery and ccls as well.
A newer project emerged from cquery. Build and install from source, see (ccls wiki)[https://github.com/MaskRay/ccls/wiki/Build]
Build and install from source, see (cquery wiki)[https://github.com/cquery-project/cquery/wiki/Building-cquery]
To use clangd on Debian/Ubuntu, add the apt repositories described here.
After that, install with e.g.
apt install clang-tools-9. The clangd executable
will have a version number suffix. For instance, clangd-9. You will thus have to
"clients" dictionary in your user preferences.
To use clangd on Mac, use Homebrew:
brew install llvm. The clangd executable
will be present in /usr/local/Cellar/llvm/version/bin
To use clangd on Windows, install LLVM with the LLVM installer, and then add C:\Program Files\LLVM\bin to your %PATH%.
For any project of non-trivial size, you probably have a build system in place to compile your source files. The compilation command passed to your compiler might include things like:
- Include directories,
- Define directives,
- Compiler-specific flags.
Like any language server, clangd works on a per-file (or per-buffer) basis. But
unlike most other language servers, it must also be aware of the exact compile
flags that you pass to your compiler. For this reason, people have come up with
the idea of a compilation database.
At this time, this is just a simple JSON file that describes for each
translation unit (i.e. a
.mm file) the exact
compilation flags that you pass to your compiler.
It's pretty much standardized that this file should be called
compile_commands.json. clangd searches for this file up in parent
directories from the currently active document. If you don't have such a file
present, most likely clangd will spit out nonsense errors and diagnostics about
As it turns out, CMake can generate this file for you if you pass it the
-DCMAKE_EXPORT_COMPILE_COMMANDS=ON when invoking CMake. It will
be present in your build directory, and you can copy that file to the root of
your project. Make sure to ignore this file in your version control system.
If you are using a make-based build system, you could use compiledb
to generate a
Since header files are (usually) not passed to a compiler, they don't have compile commands. So even with a compilation database in place, clangd will still spit out nonsense in header files. You can try to remedy this by enhancing your compilation database with your header files using this project called compdb.
To generate headers with compdb, read this closed issue.
You can also read about attempts to address this on the CMake issue tracker, along with the problem of treating header files as translation units.