qbit/go
1
0
Fork 0
mirror of https://github.com/golang/go synced 2024-11-05 19:46:11 -07:00
Code Releases Activity
77f530d86f
go/gopls/doc/troubleshooting.md
Hana (Hyang-Ah) Kim 7cb253f4c4 gopls/doc/troubleshooting.md: update the gopls output channel name 
Since v0.15.0, VS Code Go extension uses the `gopls (server)` channel
for the server-side logging.

Change-Id: I6dc2125af59562576d20e29a0801be6b4ce394bb
Reviewed-on: https://go-review.googlesource.com/c/tools/+/240677
Reviewed-by: Rebecca Stambler <rstambler@golang.org>
2020-07-01 15:12:20 +00:00

3.0 KiB
Raw Blame History

Troubleshooting

If you see a gopls error or crash, or gopls just stops working, please follow the troubleshooting steps below.

Steps

  1. Make sure your gopls is up to date.
  2. Check the known issues.
  3. Report the issue.

File an issue

You can use:

  • Your editor's bug submission integration (if available). For instance, :GoReportGitHubIssue in vim-go.
  • gopls bug on the command line.
  • The Go issue tracker.

Along with an explanation of the issue, please share the information listed here:

  1. Your editor and any settings you have configured (for example, your VSCode settings.json file).
  2. A sample program that reproduces the issue, if possible.
  3. The output of gopls version on the command line.
  4. The output of gopls -rpc.trace -v check /path/to/file.go.
  5. gopls logs from when the issue occurred, as well as a timestamp for when the issue began to occur. See the instructions for information on how to capture gopls logs.

Much of this information is filled in for you if you use gopls bug to file the issue.

Capturing logs

VS Code

For VSCode users, the gopls log can be found by navigating to View -> Output (or Ctrl+K Ctrl+H). There will be a drop-down menu titled Tasks in the top-right corner. Select the gopls (server) item, which will contain the gopls logs.

To increase the level of detail in your logs, add the following to your VS Code settings:

"go.languageServerFlags": [
  "-rpc.trace"
]

To start a debug server that will allow you to see profiles and memory usage, add the following to your VS Code settings:

"go.languageServerFlags": [
  "serve",
  "-rpc.trace",
  "--debug=localhost:6060",
],

You will then be able to view debug information by navigating to localhost:6060.

Other editors

For other editors, you may have to directly pass a -logfile flag to gopls.

To increase the level of detail in your logs, start gopls with the -rpc.trace flag. To start a debug server that will allow you to see profiles and memory usage, start gopls with serve --debug=localhost:6060. You will then be able to view debug information by navigating to localhost:6060.

If you are unsure of how to pass a flag to gopls through your editor, please see the documentation for your editor.

Restart your editor

Once you have filed an issue, you can then try to restart your gopls instance by restarting your editor. In many cases, this will correct the problem. In VSCode, the easiest way to restart the language server is by opening the command palette (Ctrl + Shift + P) and selecting "Go: Restart Language Server". You can also reload the VSCode instance by selecting "Developer: Reload Window".