Go in Visual Studio Code

Using the Go extension for Visual Studio Code, you get features like IntelliSense, code navigation, symbol search, testing, debugging, and many more that will help you inGo development.

You can install the Go extension from the VS CodeMarketplace.

Watch"Getting started with VS Code Go" for an explanation of how to build your first Go application using VS Code Go.

This article describes only a subset of the features the Go extension provides. See the extension'sdocumentation for the full, up-to-date list of supported features.

IntelliSense

IntelliSense features are provided by the Go language server,gopls, maintained by the Go team. You can configure the behavior ofgopls using thegopls settings.

Semantic syntax highlighting

For better syntax highlighting than the default TextMate-based syntax highlighting, we recommend enablingsemantic highlighting by turning on Gopls'ui.semanticTokens setting.

"gopls": {"ui.semanticTokens":true }

Auto completions

As you type in a Go file, you can see IntelliSense providing you with suggested completions. This even works for members in current, imported, and not yet imported packages. Just type any package name followed by., and you will get suggestions for the corresponding package members.

Tip: Use⌃Space (Windows, LinuxCtrl+Space) to trigger the suggestions manually.

Hover information

Hovering on any variable, function, or struct will give you information on that item such as documentation, signature, etc.

Signature help

When you open the( while calling a function, a pop-up provides signature help for the function. As you keep typing the parameters, the hint (underline) moves to the next parameter.

Tip: Use⇧⌘Space (Windows, LinuxCtrl+Shift+Space) to manually trigger the signature help when the cursor is inside the() in the function call.

Code navigation

Code Navigation features are available in the context menu in the editor.

• Go to DefinitionF12 - Go to the source code of the type definition.
• Go to Type Definition - Go to the type that defines a symbol.
• Peek Definition⌥F12 (WindowsAlt+F12, LinuxCtrl+Shift+F10) - Bring up a Peek window with the type definition.
• Go to References⇧F12 (Windows, LinuxShift+F12) - Show all references for the type.
• Show Call Hierarchy⇧⌥H (Windows, LinuxShift+Alt+H) - Show all calls from or to a function.
• Go to Implementations⌘F12 (Windows, LinuxCtrl+F12) - Bring up a Peek window with the list of all implementations of an interface (if triggered with an interface type symbol), or interfaces a type implements (if triggered with a concrete type symbol).
• Find All Implementations - Show all implementation of an interface (if triggered with an interface type symbol), or interfaces a type implements (if triggered with a concrete type symbol).

You can navigate via symbol search using theGo to Symbol commands from the Command Palette (⇧⌘P (Windows, LinuxCtrl+Shift+P)).

• Go to Symbol in File -⇧⌘O (Windows, LinuxCtrl+Shift+O)
• Go to Symbol in Workspace -⌘T (Windows, LinuxCtrl+T)

You can also navigate back and forth between a Go file and its test implementation using theGo: Toggle Test File command.

Build and diagnose

The Go language server (gopls) detects build and vet errors found on the workspace. The errors and warnings from running any/all of the above will be shown red/green squiggly lines in the editor. These diagnostics also show up in theProblems panel (View >Problems).

You can add additional lint checks using thego.lintOnSave setting and configuring your choice of linting tool (staticcheck,golangci-lint, orrevive) using thego.lintTool setting.

Formatting

You can format your Go file using⇧⌥F (WindowsShift+Alt+F, LinuxCtrl+Shift+I) or by running theFormat Document command from the Command Palette or the context menu in the editor.

By default, formatting is run when you save your Go file. You can disable this behavior by settingeditor.formatOnSave tofalse for the[go] language identifier. You can change this using your JSON setting files.

"[go]": {        "editor.formatOnSave":false}

When you have multiple formatters activated for Go files, you can select the Go extension as the default formatter.

"[go]": {    "editor.defaultFormatter":"golang.go"}

Formatting is provided bygopls. If you wantgofumpt-style formatting, you can configuregopls to usegofumpt.

"gopls": {    "formatting.gofumpt":true}

Test

The VS CodeTest UI and editorCodeLens elements allow users to easily run tests, benchmarks, profiles for a given function, file, package, or workspace.

Alternatively, the same functionality is available through a set of commands:

• Go: Test Function At Cursor
• Go: Test File
• Go: Test Package
• Go: Test All Packages in Workspace

There are many test-related commands that you can explore by typing "Go: test" in the Command Palette.

The first three above can be used to generate test skeletons for the functions in the current package, file, or at the cursor usinggotests. The last few can be used to run tests in the current package, file, or at the cursor usinggo test. There is also a command for getting test coverage.

You can configure the extension to run tests and compute test coverage using:

• go.testOnSave
• go.coverOnSave
• go.testFlags

Import packages

The extension organizes imports, and removes unused imports by default. For different behavior, you can override per-language default settings followingthese instructions.

Run the commandGo: Add Import to get a list of packages that can be imported to your Go file. Choose one and it will get added in the import block of your Go file.

Refactoring

Select the area for refactoring (for example variable, function body, etc.). Click on the Code Action light bulb icon that appears in the selected area, or selectRefactoring... orRename Symbol (F2) from the VS Code context menu.

Debugging

The Go extension lets you debug Go code by utilizing theDelve debugger.

ReadDebug Go programs in VS Code for setup steps, supported features, configurations, information on remote debugging and a troubleshooting guide. For general debugging features such as inspecting variables, setting breakpoints, and other activities that aren't language-dependent, reviewVS Code debugging.

Some features unique to Go are:

• Local & remote debugging
• Data inspection usingDelve's expression syntax
• Dynamic configuration change and inspection options withdlv command from DEBUG CONSOLE
• Ability to hide/show system goroutines (usehideSystemGoroutines configuration)
• Disassembly view support (right-click your source code and selectOpen Disassembly View)
• Experimental function call, core inspection, Mozillarr support

Next steps

This has been a brief overview showing the Go extension features within VS Code. For more information, see the details provided in the Go extensionREADME.

To stay up to date on the latest features/bug fixes for the Go extension, see theCHANGELOG.

If you have any issues or feature requests, feel free to log them in the Go extensionvscode-go repo.

If you'd like to learn more about VS Code, try these topics:

• Basic Editing - A quick introduction to the basics of the VS Code editor.
• Install an Extension - Learn about other extensions are available in theMarketplace.
• Code Navigation - Move quickly through your source code.