llvm-project/clang-tools-extra/clangd/clients/clangd-vscode
Kirill Bobyrev db3d64eebb [clangd-vscode] NFC; Improve wording in documentation and update VSCode tasks
Summary:
VSCode tasks are updated to the latest supported versions: deprecated
values are removed and replaced by their new counterparts.

Reviewers: hokein

Reviewed By: hokein

Subscribers: ilya-biryukov, MaskRay, jkorous, arphaman, kadircet, usaxena95, cfe-commits

Tags: #clang

Differential Revision: https://reviews.llvm.org/D76595
2020-04-01 14:16:55 +02:00
..
.vscode [clangd-vscode] NFC; Improve wording in documentation and update VSCode tasks 2020-04-01 14:16:55 +02:00
doc-assets [clangd] Update clangd-vscode docs to be more user-focused. 2019-09-09 11:34:01 +00:00
src [clangd-vscode] NFC; Improve wording in documentation and update VSCode tasks 2020-04-01 14:16:55 +02:00
test [clangd][vscode] Get rid of the deprecated vscode module in the extension. 2020-01-30 11:36:08 +01:00
.gitignore [clangd] Add .vscode-test to .gitignore. 2019-08-30 09:06:18 +00:00
.vscodeignore
DEVELOPING.md [clangd-vscode] NFC; Improve wording in documentation and update VSCode tasks 2020-04-01 14:16:55 +02:00
LICENSE Update year in license files 2019-01-15 15:10:32 +00:00
README.md [clangd] some tweaks on the vscode readme, NFC 2019-09-10 08:07:12 +00:00
package-lock.json [clangd] Bump vscode-clangd v0.0.20 2020-01-30 11:45:54 +01:00
package.json [clangd] Bump vscode-clangd v0.0.21. 2020-03-09 15:36:49 +01:00
tsconfig.json [clangd-vscode] NFC; Improve wording in documentation and update VSCode tasks 2020-04-01 14:16:55 +02:00

README.md

vscode-clangd

Provides C/C++ language IDE features for VS Code using clangd:

  • code completion
  • compile errors and warnings
  • go-to-definition and cross references
  • include management
  • code formatting
  • simple refactorings

Setup

clangd server

clangd is a language server that must be installed separately, see getting started. The vscode-clangd extension will look for clangd on your PATH (you can change this in the settings).

Project setup

clangd is based on the clang C++ compiler, and understands even complex C++ code. However, you must tell clangd how your project is built (compile flags). A compile_commands.json file can usually be generated by your build system (e.g. by setting -DCMAKE_EXPORT_COMPILE_COMMANDS=1 when building with CMake, or with many other tools).

It should live at the top of your source tree: symlink or copy it there.

Features

Code completion

Suggestions will appear as you type names, or after . or ->. Because clangd uses a full C++ parser, code completion has access to precise type information.

Code completion

Errors, warnings, and clang-tidy

Code errors are shown as you type (both as red squiggle underlines, and in the "Problems" panel). These are the same as produced by the clang compiler, and suggested fixes can automatically be applied.

Error with fix

Most clang-tidy checks are supported (these can be enabled using a .clang-tidy file).

Cross-references

Go-to-definition and find-references work across your code, using a project-wide index.

Cross-reference list

Press Ctrl-P # to quickly navigate to a symbol by name.

Include management

Code completion works across your codebase and adds #include directives where needed. The shows includes that will be inserted.

clangd can also suggest inserting missing #includes, where they cause errors.

Fix inserts include

Formatting

clangd uses the clang-format engine. You can format a file or the selection. When "Format on Type" is enabled in the settings, pressing enter will cause clangd to format the old line and semantically reindent.

Format-on-type

The style used for formatting (and certain other operations) is controlled by the .clang-format file is controlled by the project's .clang-format file.

Refactoring

clangd supports some local refactorings. When you select an expression or declaration, the lightbulb menu appears and you can choose a code action.

Extract variable code action

Current refactorings include:

  • extract variable/function
  • expand auto types and macros
  • use raw strings
  • rename (bound to <F2>, rather than a contextual code action)

Bugs/contributing

clangd and vscode-clangd are part of the LLVM project.

If you'd like to help out, reach out to clangd-dev@lists.llvm.org.

If you've found a bug, please file at https://github.com/clangd/clangd/issues.