Гайд · TNWS AI

Как проверить выделенный фрагмент кода через Copilot Review в VS Code

Copilot

13 сентября 2026 6 мин—

Локальный review выбранного кода в VS Code через Generate Code → Review: подготовка контекста, Comments panel, inline-комментарии и проверяемый пример.

Конкретная задача и применимость

Этот гайд помогает получить первичный review только выбранной функции, не отправляя весь незакоммиченный diff и не создавая pull request. Он подходит для точечной проверки алгоритма, обработчика ошибок или чувствительной функции перед более широким code review. Результатом считается не сообщение модели об успехе, а состояние, которое можно проверить независимо: активный login, список reviewer, комментарий в IDE, URL pull request или отсутствие изменений в рабочем дереве.

Названия команд, меню, приоритеты credentials и доступность функций проверены 13 сентября 2026 года по официальной документации GitHub. Цены, квоты и номера версий здесь не приводятся: для сценария они не нужны, быстро меняются и должны проверяться отдельно. Организационная политика может отключать функцию даже при корректной локальной настройке.

Что подтверждено официально

Официальный VS Code workflow: выделить код, вызвать context menu, выбрать Generate Code → Review. Результат появляется в Comments panel и inline в editor. Формулировка важна: похожая команда или кнопка может запускать другой workflow. Если ваш интерфейс отличается, не угадывайте — откройте первоисточник в конце статьи и найдите актуальный раздел.

Подготовка безопасной проверки

Перед началом зафиксируйте ожидаемый аккаунт, hostname, repository и допустимый тип действия. Для локального review очистите рабочую область от несвязанных правок. Для GitHub CLI сначала проверьте gh auth status, текущий remote и номер pull request. Для авторизации не выводите tokens и одноразовые коды в общий log.

Разделите наблюдение и изменение. Сначала выясните текущее состояние, затем выполните ровно одну операцию, после чего снова прочитайте состояние. Такой цикл защищает от двойного POST, повторного назначения reviewer и входа не под тем пользователем.

Готовый шаблон

Скопируйте заготовку и замените только понятные placeholders:

Контекст проверки: функция рассчитывает скидку. Инварианты: итог не ниже нуля; купон применяется один раз; неизвестный тип купона отклоняется.

Не помещайте в шаблон настоящее значение token, cookie, device code или внутренний URL. Для CI подставляйте secret из защищённого store на уровне process environment. Для pull request храните body в отдельном Markdown-файле, чтобы до внешнего действия проверить diff и содержание.

Пошаговые действия

Откройте файл в VS Code и прочитайте функцию вместе с типами и ближайшими вызовами. Review выделения не видит автоматически всю бизнес-историю.
Выделите законченную смысловую единицу: сигнатуру и тело функции, а не одну подозрительную строку.
Нажмите правой кнопкой по выделению и выберите Generate Code → Review.
Дождитесь результата. Откройте Comments panel и сравните его с inline-комментариями в editor.
Для каждого замечания сформулируйте конкретный вход, ожидаемый результат и фактическое поведение. Отбросьте советы, не относящиеся к выбранной функции.
Исправьте код вручную или примените только понятную suggestion. Затем запустите узкий тест на найденный сценарий.
Повторите выделенный review после исправления и завершите обычной проверкой всего diff перед commit.

На каждом шаге задавайте вопрос: что изменилось и где это видно? Успешный exit code полезен, но недостаточен. Внешнее состояние подтверждают страница GitHub и reviewer list; локальное — /user, comments panel, IDE diff, git status и тесты.

Готовый промпт для копирования

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

Хороший prompt содержит объект, границы и критерий остановки. Запрет на запись не заменяет системные permissions, зато делает неожиданное write-действие заметным. Для review добавляйте инварианты и негативные сценарии: общая просьба «проверь код» даёт менее проверяемый результат.

Реалистичный пример

Вход: Выделена applyDiscount(total, coupon), где процент применяется до проверки total > 0, а неизвестный coupon silently ignored.

Ожидаемый результат: Comments panel и inline review указывают на негативный сценарий и отсутствие явной ошибки; разработчик добавляет тесты и перепроверяет функцию.

После ответа не соглашайтесь автоматически. Сопоставьте login и hostname, откройте URL, прочитайте аргументы команды или воспроизведите сценарий тестом. Если результат невозможно проверить без доверия к тексту Copilot, процедура ещё не завершена.

Как проверить результат без модели

Для CLI-аутентификации используйте /user, повторный запуск процесса и отсутствие неожиданных environment overrides. Для GitHub CLI откройте pull request через gh pr view --web и посмотрите Reviewers. Для IDE-review перечитайте изменённые строки, Comments/Problems и итоговый diff.

Проверяйте также отрицательный результат. После logout защищённая операция должна требовать вход. После отказа от suggestion файл не должен измениться. После назначения одного reviewer остальные поля PR должны остаться прежними. Отрицательная проверка ловит частичные и ложноположительные успехи.

Наконец, запустите проектные тесты. Copilot review обнаруживает потенциальный риск, но не выполняет роль формального доказательства. Для каждой принятой правки добавьте или обновите тест, который падает на старом поведении и проходит на новом.

Типовые ошибки

Слишком маленькое выделение лишает review сигнатуры и инвариантов.
Comments panel — навигация, но истинность замечания доказывает тест.
Локальный selection review не заменяет PR review взаимодействий между файлами.

При неоднозначном сбое не повторяйте команду вслепую. Сначала прочитайте текущее состояние. Повторная авторизация может добавить другой аккаунт, а повторный внешний запрос — создать нежелательное действие или шум в audit log.

Безопасность и эксплуатация в команде

Используйте минимальную область доступа. OAuth выдавайте нужному аккаунту и нужным организациям; PAT ограничивайте repository access и сроком; reviewers назначайте только правильному PR. Не передавайте credentials аргументом командной строки: они могут попасть в history и список процессов.

Сохраняйте процесс, а не секрет. В командной документации полезны точные команды, ожидаемые признаки успеха и процедура отзыва. Значения tokens, одноразовые коды и персональные данные должны оставаться в secret store или интерактивном защищённом flow.

Чек-лист финальной проверки

Использованы точные команды и пункты меню из официального источника, проверенного 13 сентября 2026 года.
Подтверждены правильные login, hostname, OWNER/REPO и номер PR.
В prompt, shell history, Markdown и логах нет token или device code.
Выполнена ровно одна целевая операция без повторов и дублей.
Результат проверен через /user, GitHub UI, IDE comments или git diff.
Все принятые code suggestions перепроверены тестами.
Неожиданные env credentials исключены или документированы.
Для logout/инцидента проверены также server-side revoke и отдельные PAT.

FAQ

Какое точное меню?

Context menu выделения → Generate Code → Review.

Где появляются комментарии?

В Comments panel и inline в редакторе.

Нужно ли создавать PR?

Нет, это локальный первичный review выбранного кода.

Что выделять?

Минимальную законченную единицу с сигнатурой и телом, чтобы сохранить контекст.

Официальный первоисточник

GitHub Docs: официальная инструкция

Источник и изменяемые детали проверены 13 сентября 2026 года. Перед повторением после обновления Copilot CLI, GitHub CLI, VS Code или JetBrains IDE снова откройте документацию и сравните точные имена команд и элементов интерфейса.