Gopls: Устранение неполадок

Если вы подозреваете, что gopls вылетает или работает некорректно, пожалуйста, следуйте нижеприведённым шагам устранения неполадок.

Если gopls использует слишком много памяти, пожалуйста, следуйте инструкциям в разделе Использование памяти.

Шаги

Пользователи VS Code должны следовать их руководству по устранению неполадок, которое содержит более специфичную версию этих инструкций.

1. Убедитесь, что ваш проект находится в рабочем состоянии, работая с ним вне редактора. Запуск команды вроде go build ./... в директории рабочей области скомпилирует всё. Для модулей, go mod tidy также является хорошей проверкой, хотя она может изменить ваш go.mod.
2. Проверьте, чтобы редактор не показывал диагностические сообщения, указывающие на проблему с вашей рабочей областью. Они могут появляться как диагностические сообщения в объявлении пакета Go-файла, диагностические сообщения в файле go.mod или как сообщения о статусе или прогрессе. Проблемы в конфигурации рабочей области могут вызывать множество различных симптомов. См. инструкции по настройке рабочей области для получения помощи.
3. Убедитесь, что gopls является актуальной версии, следуя инструкциям по установке, а затем перезапустите gopls.
4. По желанию, запросите помощь в Gophers Slack.
5. Наконец, сообщите о проблеме разработчикам gopls.

Перезапуск gopls

gopls не имеет постоянного состояния, поэтому перезапуск решит временные проблемы. Это хорошо и плохо: хорошо, потому что вы сможете продолжать работать, и плохо, потому что вы не сможете отладить проблему до её повторного возникновения.

В большинстве случаев закрытие всех открытых редакторов гарантирует, что gopls будет завершён и перезапущен. Если вы не хотите делать это, возможно, существует команда редактора, которую можно использовать для перезапуска только gopls. Обратите внимание, что некоторые конфигурации vim сохраняют сервер активным некоторое время после выхода из редактора; возможно, вам потребуется явно завершить gopls, если вы используете vim.

Запрос помощи

Gophers Slack имеет активные каналы, специфичные для редакторов, такие как #emacs, #vim и #vscode, которые могут помочь в дальнейшей отладке. Если вы уверены, что проблема связана с gopls, вы можете сразу перейти в канал #gopls. Приглашения доступны для всех. Подготовьтесь к краткому описанию проблемы и постарайтесь быть доступным для ответов на вопросы в течение некоторого времени после этого.