This documentation is for advanced
gopls users, who may want to test unreleased versions or try out special features.
To get a specific version of
gopls (for example, to test a prerelease version), run:
GO111MODULE=on go install golang.org/x/tools/gopls@vX.Y.Z
vX.Y.Z is the desired version.
gopls to the latest unstable version, use the following commands.
# Create an empty go.mod file, only for tracking requirements. cd $(mktemp -d) go mod init gopls-unstable # Use 'go get' to add requirements and to ensure they work together. go get -d golang.org/x/tools/gopls@master golang.org/x/tools@master go install golang.org/x/tools/gopls
If you are working on the Go project itself, the
go command that
gopls invokes will have to correspond to the version of the source you are working on. That is, if you have checked out the Go project to
go command should be the
$HOME/go/bin/go executable that you built with
make.bash or equivalent.
You can achieve this by adding the right version of
go to your
export PATH=$HOME/go/bin:$PATH on Unix systems) or by configuring your editor.
To enable this support, you need to build gopls with a version of Go that supports generics. The easiest way to do this is by installing the Go 1.18 Beta as described at Tutorial: Getting started with generics#prerequisites, and then using this Go version to build gopls:
$ go1.18beta2 install golang.org/x/tools/gopls@latest
When using the Go 1.18, it is strongly recommended that you install the latest version of
gopls, or the latest unstable version as described above.
You also need to make
gopls select the beta version of
<GOROOT>/go/bin where GOROOT is the location reported by
go1.18beta2 env GOROOT) by adding it to your
PATH or by configuring your editor.
gopls built with these instructions understands generic code. To actually run the generic code you develop, you must also use the beta version of the Go compiler. For example:
$ go1.18beta2 run .
staticcheck on generic code is not supported yet.
please follow the v0.8.0 milestone to see the list of go1.18-related known issues and our progress.