Перейти на код Visual Studio

Расширение VS Code Go обеспечивает богатую языковую поддержку языка программирования Go.

Требования

Visual Studio Code 1.75 или новее (или редакторы, совместимые с API VS Code 1.75+)
Перейти 1.21 или новее.

Быстрый старт

Добро пожаловать! ??
Независимо от того, являетесь ли вы новичком в Go или опытным разработчиком Go, мы надеемся, что это расширение соответствует вашим потребностям и улучшает ваш опыт разработки.

Установите Go 1.21 или новее, если вы еще этого не сделали.
Установите расширение VS Code Go.
Откройте любой файл Go или файл go.mod, чтобы автоматически активировать расширение. Строка состояния Go появляется в правом нижнем углу окна и отображает вашу версию Go.
Расширение зависит от go , gopls (языкового сервера Go) и дополнительных инструментов в зависимости от ваших настроек. Если gopls отсутствует, расширение попытается его установить. Знак ⚡ рядом с версией Go означает, что языковой сервер запущен и вы готовы к работе.

(Установить недостающие инструменты)

Вы готовы идти :-) ???

Что дальше

Узнайте больше о возможностях расширения VS Code Go.
Просмотрите документацию по настройкам и дополнительные темы, чтобы настроить расширение.
Просмотрите документацию по инструментам, чтобы получить полный список инструментов, от которых зависит расширение VS Code Go. Вы можете установить дополнительные инструменты и обновить их, используя «Перейти: Инструменты установки/обновления».
Решайте проблемы с помощью общих руководств по устранению неполадок и отладке.
подать заявку на проблемы с расширением.
Начните обсуждение на GitHub или получите помощь по Stack Overflow.
Изучите ресурсы языка Go на сайтах go.dev/learn и golang.org/help.

Если вы новичок в Go, в этой статье представлен обзор организации кода Go и основных команд go . Посмотрите «Начало работы с VS Code Go», чтобы узнать, как создать свое первое приложение Go с помощью VS Code Go.

Основные характеристики

IntelliSense — результаты для символов появляются по мере их ввода.
Навигация по коду — перейдите к объявлению символа или просмотрите его.
Редактирование кода — поддержка сохраненных фрагментов, форматирование и организация кода, а также автоматическая организация импорта.
Диагностика — ошибки сборки, проверки и проверки отображаются при вводе или при сохранении.
Расширенная поддержка тестирования и отладки.

Для получения более подробной информации ознакомьтесь с полным описанием функций.

(Завершение кода и помощь по подписи)

Помимо встроенных функций редактирования, расширение предоставляет несколько команд для работы с файлами Go. Вы можете получить доступ к любой из них, открыв палитру команд ( Ctrl+Shift+P в Linux/Windows и Cmd+Shift+P в Mac), а затем введя имя команды. См. полный список команд, предоставляемых этим расширением.

(Переключить тестовый файл)

⚠️ Примечание . Подсветка синтаксиса по умолчанию для файлов Go обеспечивается правилом TextMate, встроенным в VS Code, а не этим расширением.

Для лучшей подсветки синтаксиса мы рекомендуем включить семантическую подсветку, включив настройку Gopls ui.semanticTokens . "gopls": { "ui.semanticTokens": true }

Настройка вашего рабочего пространства

Расширение VS Code Go поддерживает режимы модулей GOPATH и Go.

Модули Go используются для управления зависимостями в последних версиях Go. Модули заменяют основанный на GOPATH подход к указанию того, какие исходные файлы используются в данной сборке, и являются режимом сборки по умолчанию в go1.16+. Мы настоятельно рекомендуем разработку Go в модульном режиме. Если вы работаете над существующими проектами, рассмотрите возможность перехода на модули.

В отличие от традиционного режима GOPATH , режим модуля не требует расположения рабочей области под GOPATH или использования определенной структуры. Модуль определяется деревом каталогов исходных файлов Go с файлом go.mod в корневом каталоге дерева.

Ваш проект может включать один или несколько модулей. Если вы работаете с несколькими модулями или необычными макетами проектов, вам необходимо настроить рабочее пространство с помощью папок рабочего пространства. Дополнительную информацию см. в документации по поддерживаемым макетам рабочей области.

Предварительная версия

Если вы хотите получить ранний доступ к новым функциям и исправлениям ошибок, вы можете использовать предварительное расширение. Следуя соглашению vscode, мы используем младшую версию номера версии расширения, чтобы различать стабильные и предварительные версии ( 0.ODD_NUMBER.patch для предварительной версии, 0.EVEN_NUMBER.patch для стабильной версии).

Чтобы установить предварительную версию, в раскрывающемся списке выберите «Установить предварительную версию» или, если расширение Go уже установлено, используйте параметр «Переключиться на предварительную версию» в управлении расширениями кода Visual Studio. страница. Дополнительные сведения об этом механизме см. в документации Visual Studio Code.

Телеметрия

Расширение VS Code Go использует телеметрию Go для получения информации о производительности и стабильности расширения и языкового сервера ( gopls ). Загрузка данных телеметрии Go по умолчанию отключена , но ее можно включить с помощью следующей команды:

go run golang.org/x/telemetry/cmd/gotelemetry@latest on

После включения телеметрии языковой сервер будет загружать метрики и трассировки стека на сайт telemetry.go.dev. Вы можете проверить, какие данные собираются и могут быть загружены, выполнив:

go run golang.org/x/telemetry/cmd/gotelemetry@latest view

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

Даже при использовании полуавтоматических отчетов о сбоях в VS Code мы видели, как о некоторых сбоях не сообщалось в течение недель или месяцев.
Даже при использовании набора тестов некоторые снижения производительности не проявляются в нашей тестовой среде (например, ошибка завершения, упомянутая ниже!).
Даже имея множество отличных идей по улучшению гоплов, наши ресурсы ограничены. Телеметрия может помочь нам определить, какие новые функции наиболее важны, а какие существующие функции не используются или работают плохо.

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

Телеметрия Go спроектирована так, чтобы быть прозрачной и сохранять конфиденциальность. Подробную информацию можно найти на странице https://go.dev/doc/telemetry.

Политика поддержки

Расширение Go поддерживается инженерами из группы инструментов Go, которые активно следят за VS Code Go и средствами отслеживания проблем Go.

Мы поддерживаем только последние стабильные и предварительные версии расширения.

Поддерживаемые Go и инструменты

Расширение Go соответствует политике выпуска Go, что означает, что оно официально поддерживает два последних основных выпуска Go. Команда Go обеспечивает максимальную поддержку последних трех основных версий Go.

Расширение Go использует такие инструменты, как gopls и dlv для реализации своих основных функций, и у них есть собственная политика и график выпуска. Мы тестируем только последние версии этих инструментов.

Если вам нужно работать с более старой версией Go, проверьте страницу «Совместимость» и вручную установите совместимую версию расширения и инструментов.

Содействие

Мы приветствуем ваш вклад и благодарим вас за работу над улучшением опыта разработки Go в VS Code. Если вы хотите помочь в работе над расширением VS Code Go, ознакомьтесь с нашим руководством по участию, чтобы узнать, как создать и запустить расширение VS Code Go локально и внести свой вклад в проект.

Нормы поведения

Этот проект следует Кодексу поведения сообщества Go. Если у вас возникнут проблемы, связанные с поведением, отправьте электронное письмо по адресу [email protected].