SourceKit-LSP is an implementation of the Language Server Protocol (LSP) for Swift and C-based languages. It provides features like code-completion and jump-to-definition to editors that support LSP. SourceKit-LSP is built on top of sourcekitd and clangd for high-fidelity language support, and provides a powerful source code index as well as cross-language support. SourceKit-LSP supports projects that use the Swift Package Manager.
SourceKit-LSP is under heavy development! The best way to try it out is to build it from source. You will also need a Swift development toolchain and an editor that supports LSP.
swift-DEVELOPMENT-SNAPSHOT-2018-11-01-atoolchain snapshot from https://swift.org/download/. Set the environment variable
SOURCEKIT_TOOLCHAIN_PATHto the absolute path to the toolchain or otherwise configure your editor to use this toolchain. See Toolchains for more information.
Build the language server executable
swift build. See Building for more information.
Configure your editor to use the newly built
sourcekit-lspexecutable. See Editors for more information about editor integration.
Build the project you are editing with
swift build. The language server depends on the build to provide module dependencies and to update the global index.
SourceKit-LSP is built using the Swift Package Manager.
For a standard debug build:
$ swift build
After building, the server will be located at
.build/debug/sourcekit-lsp, or a similar path, if you passed any custom options to
swift build. Editors will generally need to be provided with this path in order to run the newly built server - see Editors for more information about configuration.
Building on Linux
The C++ code in the index requires
libdispatch, but unlike Swift code, it cannot find it automatically on Linux. You can work around this by adding a search path manually.
$ swift build -Xcxx -I<path_to_swift_toolchain>/usr/lib/swift
Using the Generated Xcode Project
If you would like to use the Xcode project generated by
swift package generate-xcodeproj, you will need to include the xcconfig overrides to avoid a link error.
$ swift package generate-xcodeproj --xcconfig-overrides overrides.xcconfig $ open SourceKitLSP.xcodeproj
SourceKit-LSP depends on tools such as
clangd, which it loads at runtime from an installed toolchain.
swift-DEVELOPMENT-SNAPSHOT-2018-11-01-a toolchain snapshot from https://swift.org/download/#snapshots. It can be found under "Older Snapshots" as "November 1, 2018". SourceKit-LSP is still early in its development and we are actively adding functionality to the toolchain to support it.
Selecting the Toolchain
After installing the toolchain, SourceKit-LSP needs to know how to find it. Your editor may have a way to do this directly via a configuration setting, or it may allow you to override the process environment variables used when launching
sourcekit-lsp. See Editors for more information.
The simplest way to configure the toolchain is to set the following environment variable to the absolute path of the toolchain.
Indexing While Building
SourceKit-LSP uses a global index called IndexStoreDB to provide features that cross file or module boundaries, such as jump-to-definition or find-references. To efficiently create an index of your source code we use a technique called "indexing while building". When the project is compiled for debugging using
swift build, the compiler (swiftc or clang) automatically produces additional raw index data that is read by our indexer. Producing this information during compilation saves work and ensures that any time the project is built the index is updated and fully accurate.
In the future we intend to also provide automatic background indexing so that we can update the index in between builds or to include code that's not always built like unit tests. In the meantime, building your project should bring our index up to date.
SourceKit-LSP is still in early development, so you may run into rough edges with any of the features. The following table shows the status of various features when using the Recommended Toolchain. See Caveats for important known issues you may run into.
|C/C++/ObjC||❌||clangd is not available in the recommended toolchain. You can try out C/C++/ObjC support by building clangd from source and putting it in
|Quick Help (Hover)||✅|
|Jump to Definition||✅|
|Background Indexing||❌||Build project to update the index using Indexing While Building|
|Syntax Highlighting||❌||Not currently part of LSP.|
Indexing does not work on Linux (jump-to-definition, find references)
- Should be fixed in the next Swift snapshot by swift-clang#219
SwiftPM build settings are not updated automatically after files are added/removed.
- Workaround: close and reopen the project after adding/removing files
SourceKit-LSP does not update its global index in the background, but instead relies on indexing-while-building to provide data. This only affects global queries like find-references and jump-to-definition.
- Workaround: build the project to update the index