Поиск изменений кода и других журналов с помощью CodeLens

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

Примечание.

CodeLens доступен в выпуске Community Visual Studio; Однако индикаторы системы управления версиями недоступны в этом выпуске.

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

Screenshot of the CodeLens indicators in the code editor.

Чтобы выбрать, какие индикаторы должны отображаться, или чтобы включить или выключить средство CodeLens, последовательно выберите пункты Инструменты>Параметры>Текстовый редактор>Все языки>CodeLens.

Поиск ссылок на код

Можно находить ссылки в коде Visual Basic или C#. Это делается следующим образом.

  1. В редакторе кода выберите индикатор ссылок или нажмите клавиши ALT+2.

    Примечание.

    Если индикатор отображает 0 ссылок, у вас нет ссылок из кода C# или Visual Basic. Однако в других элементах, таких как XAML и .aspx файлы, могут быть ссылки.

  2. Чтобы просмотреть код ссылки, наведите указатель мыши на ссылку в списке.

  3. Чтобы открыть файл, который содержит ссылку, дважды щелкните эту ссылку.

Карты кода

Чтобы просмотреть отношения между этим кодом и его ссылками, создайте карту кода. В контекстном меню карты кода выберите Показать все ссылки.

Поиск изменений в коде

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

Необходимые компоненты:

Для кода на C# или Visual Basic, который хранится вместе с системой управления версиями Team Foundation (TFVC) или Git, сведения CodeLens предоставляются на уровнях класса и метода (индикаторы уровня кода элемента).

Для типов файлов, отличных от .cs или .vb, вы получите сведения о CodeLens для всего файла в одном месте (индикаторы уровня файла).

Индикаторы кода на уровне элемента

Индикаторы кода на уровне элемента позволяют увидеть, кто изменил ваш код и какие изменения были внесены. Индикаторы на уровне элемента кода доступны для кода на C# и Visual Basic.

Журнал изменений также можно просмотреть при использовании система управления версиями Team Foundation (TFVC) в Azure DevOps Services.

Период времени по умолчанию — последние 12 месяцев.

Чтобы просмотреть подробный журнал всех изменений, включая изменения, внесенные более года назад, выберите "Показать все изменения файла", которое открывает окно журнала .

В окне журнала можно просмотреть все файлы, которые находятся в репозитории Git. Затем можно выбрать индикатор изменений на уровне элемента кода для получения дополнительных сведений.

Индикаторы уровня файлов

Вы также можете просмотреть индикаторы уровня файла для всего файла.

Примечание.

Индикаторы на уровне файла недоступны для файлов C# и Visual Basic.

Чтобы получить дополнительные сведения об изменении, щелкните элемент правой кнопкой мыши. В зависимости от того, используете ли вы TFVC или Git, существуют варианты сравнения версий файла, просмотра сведений и отслеживания набора изменений, получения выбранной версии файла и отправки электронной почты автору этого изменения. Некоторые из этих сведений отображаются в команде Обозреватель, если она включена; в противном случае эти сведения отображаются в изменениях Git.

Вы также можете увидеть, кто изменил код с течением времени, что поможет вам найти закономерности в изменениях вашей команды и оценить их влияние.

Поиск изменений в текущем подразделении

У вашей команды может быть несколько ветвей, например основная ветвь и дочерняя ветвь разработки, чтобы снизить риск нарушения стабильного кода. Вы можете узнать, сколько людей изменило код и сколько изменений было внесены в основную ветвь, нажав клавиши ALT+6.

Поиск разветвления кода

Чтобы определить, когда ваш код был разделен на ветви, перейдите к коду в дочерней ветви. Затем выберите индикатор изменений (или нажмите клавиши ALT+6).

Поиск входящих изменений от других подразделений

Вы можете просмотреть входящие изменения. И вам не нужно оставлять текущую ветвь для просмотра изменений.

Поиск объединения изменений

Вы можете увидеть, когда изменения были объединены, чтобы определить, какие изменения включены в ветвь.

Сравнение входящего изменения с локальной версией

Чтобы сравнить входящие изменения с локальной версией, дважды щелкните набор изменений или нажмите клавиши SHIFT+F10.

Значки ветвей

Значок в столбце Ветвь показывает связь с ветвью, в которой вы работаете.

Значок Откуда пришли изменения:
CodeLens: Change from current branch icon Текущее подразделение
CodeLens: Change from parent branch icon Родительское подразделение
CodeLens: Change from child branch icon Дочернее подразделение
CodeLens: Change from peer branch icon Одноранговое подразделение
CodeLens: Change from branch further away icon Подразделение, отличное от родительского, дочернего или однорангового
CodeLens: Merge from parent icon Слияние с данными от родительского подразделения с дочерним подразделением
CodeLens: Merge from child branch icon Слияние с данными от дочернего подразделения с родительским подразделением
CodeLens: Merge from unrelated branch icon Слияние с данными от несвязанного подразделения (слияние без базовой версии)

Связанные рабочие элементы

Найдите связанные рабочие элементы, выбрав индикатор рабочие элементы или нажав ALT+8.

Связанные проверки кода

Найдите связанные проверки кода, выбрав индикатор проверки. Чтобы перемещаться по индикаторам с помощью клавиатуры, при нажатой клавише ALT нажимайте СТРЕЛКУ ВЛЕВО или СТРЕЛКУ ВПРАВО.

Связанные ошибки

Найдите связанные ошибки, выбрав индикатор ошибки или нажав ALT+7.

Обращение к владельцу элемента

Найдите автора элемента, выбрав индикатор авторы или нажав ALT+5.

Вы также можете открыть контекстное меню для элемента, чтобы просмотреть параметры контакта. (Если вы установили Teams, у вас есть дополнительные возможности обмена данными.)

Связанные модульные тесты

Вы можете узнать, какие имеются модульные тесты для вашего кода C# или Visual Basic, не открывая обозреватель тестов.

  1. Перейдите к коду приложения, содержащему связанный код модульного теста.

  2. Если вы еще не сделали этого, создайте приложение для загрузки индикаторов тестирования CodeLens.

  3. Просмотрите тесты для кода, нажав сочетание клавиш ALT+3.

  4. Если вы видите значок warning iconпредупреждения, тесты еще не выполняются, поэтому запустите их.

  5. Чтобы просмотреть определение теста, откройте файл кода в редакторе, дважды щелкнув элемент теста в окне индикаторов CodeLens.

  6. Чтобы просмотреть результаты теста, выберите индикатор состояния теста (test failed iconили) или test passed iconнажмите клавиши ALT+1.

  7. Чтобы увидеть, сколько пользователей изменяло данный тест, кто именно изменял тест или сколько изменений было внесено в тест, найдите журнал кода и связанные элементы.

Сочетания клавиш

Чтобы выбрать индикатор с помощью клавиатуры, нажмите и удерживайте клавишу ALT для отображения номеров индикаторов, а затем нажмите цифру с номером индикатора, который необходимо выбрать.

Примечание.

Чтобы выбрать индикатор проверки, удерживайте нажатой клавишу ALT и нажимайте клавиши со стрелками влево и вправо для перехода.

Вопросы и ответы

Вопрос: Разделы справки отключить CodeLens или включить или выбрать индикаторы для просмотра?

Ответ. Включать и выключать можно все индикаторы, кроме индикатора ссылок. Последовательно выберите пункты Сервис>Параметры>Текстовый редактор>Все языки>CodeLens.

Если индикаторы включены, параметры CodeLens можно также открыть из индикаторов. И вы можете включить и отключить индикаторы уровня файла CodeLens с помощью значков шеврона в нижней части окна редактора.

Вопрос. Где находится CodeLens?

Ответ. CodeLens отображается в коде C# и Visual Basic на уровне метода, класса, индексатора и свойства. Для всех других типов файлов CodeLens отображается на уровне файла.

  • Включите CodeLens. Последовательно выберите пункты Сервис>Параметры>Текстовый редактор>Все языки>CodeLens.

  • Индикаторы, связанные с Azure DevOps, отображаются только в том случае, если рабочие элементы связаны с кодом и когда у вас есть разрешения на открытие связанных рабочих элементов. Убедитесь в наличии разрешений члена команды.

  • Индикаторы модульных тестов не отображаются, если в коде приложения отсутствуют модульные тесты. Индикаторы состояния теста отображаются автоматически в тестовых проектах. Если известно, что код приложения имеет модульные тесты, но индикаторы тестов не отображаются, попробуйте выполнить сборку решения (CTRL+SHIFT+B).

Совет

CodeLens доступен в версии сообщества Visual Studio Community, однако в этой версии индикаторы управления source control недоступны.

Вопрос: Почему я не вижу сведения рабочего элемента для фиксации?

Ответ. Это может произойти, так как CodeLens не может найти рабочие элементы в Azure Boards. Проверьте, что вы подключены к проекту, который имеет эти рабочие элементы, и что имеются разрешения для просмотра этих рабочих элементов. Сведения о рабочем элементе также могут не отображаться, если описание фиксации содержит неверные сведения об идентификаторах рабочих элементов в Azure Boards.

Вопрос. Как изменить шрифт и цвет CodeLens?

Ответ. Последовательно выберите пункты Сервис>Параметры>Среда>Шрифты и цвета.

CodeLens - Change font and color settings

Для использования клавиатуры выполните следующие действия.

  1. Нажмите ALT+T+O, чтобы открыть диалоговое окно Параметры.

  2. Нажмите клавишу СТРЕЛКА ВВЕРХ или СТРЕЛКА ВНИЗ , чтобы перейти к узлу Среда , а затем нажмите клавишу СТРЕЛКА ВЛЕВО , чтобы развернуть узел.

  3. Нажмите клавишу СТРЕЛКА ВНИЗ , чтобы перейти к пункту Шрифты и цвета.

  4. Нажмите клавишу TAB, чтобы перейти к списку Параметры для, после чего нажмите клавишу СТРЕЛКА ВНИЗ, чтобы выбрать CodeLens.

В. Можно ли переместить HUD-элемент CodeLens?

Ответ. Да, выберите Dock icon закрепление CodeLens в качестве окна.

В. Как обновить индикаторы?

Ответ. Это зависит от индикатора.

  • Ссылки: этот индикатор обновляется автоматически при изменении кода. Если индикатор ссылок закреплен в отдельном окне, обновите индикатор, нажав кнопку "Обновить".

  • Команда. Обновите эти индикаторы, выбрав "Обновить индикаторы команды CodeLens" в меню правой кнопкой мыши.

  • Тест: найдите модульные тесты для кода, чтобы обновить индикатор Тест.

Вопрос. Что такое "Локальная версия"?

Ответ. Стрелка Локальная версия указывает на последний набор изменений в локальной версии файла. Если на сервере находятся более новые наборы изменений, они отображаются над или под стрелкой Локальная версия в зависимости от порядка сортировки наборов изменений.

Вопрос. Мои индикаторы тестов CodeLens больше не отображаются в файле, когда я впервые открываю решение. Как их загрузить?

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

CodeLens позволяет сосредоточиться на работе, пока вы узнаете, что произошло с кодом, не выходя из редактора. Вы можете найти ссылки на фрагмент кода, изменения кода, связанные ошибки, рабочие элементы, проверки кода и модульные тесты.

Примечание.

CodeLens доступен в версии сообщества Visual Studio Community, однако в этой версии индикаторы управления source control недоступны.

Посмотрите, где и как отдельные части вашего кода используются в решении.

CodeLens indicators in the code editor

Сообщите рабочей группе об изменениях в коде, не выходя из редактора.

CodeLens - Contact your team

Чтобы выбрать, какие индикаторы должны отображаться, или чтобы включить или выключить средство CodeLens, последовательно выберите пункты Инструменты>Параметры>Текстовый редактор>Все языки>CodeLens.

Поиск ссылок на код в Visual Studio 2019

Можно находить ссылки в коде Visual Basic или C#.

  1. Выберите индикатор ссылок или нажмите ALT+2.

    CodeLens references

    Примечание.

    Если в индикаторе отображается 0 ссылок, это значит, что ссылки из кода C# или Visual Basic отсутствуют. Однако могут существовать ссылки из других элементов, таких как XAML- и ASPX-файлы.

  2. Чтобы просмотреть код ссылки, наведите указатель мыши на ссылку в списке.

    CodeLens - Peek reference

  3. Чтобы открыть файл, который содержит ссылку, дважды щелкните эту ссылку.

Карты кода

Чтобы просмотреть отношения между этим кодом и его ссылками, создайте карту кода. В контекстном меню карты кода выберите Показать все ссылки.

CodeLens - References on code map

Поиск изменений в коде в Visual Studio 2019

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

Необходимые компоненты:

Для кода на C# или Visual Basic, который хранится вместе с системой управления версиями Team Foundation (TFVC) или Git, сведения CodeLens предоставляются на уровнях класса и метода (индикаторы уровня кода элемента).

Code element-level indicators

Для типов файлов, отличных от .cs и .vb, сведения о CodeLens по всему файлу приводятся в одном месте — в нижней части окна (индикаторы уровня файла).

File-level CodeLens indicators

Индикаторы кода на уровне элемента

Индикаторы кода на уровне элемента позволяют увидеть, кто изменил ваш код и какие изменения были внесены. Индикаторы на уровне элемента кода доступны для кода на C# и Visual Basic.

Это то, что вы видите при использовании система управления версиями Team Foundation (TFVC) или Azure DevOps Services:

CodeLens: Get change history for your code in TFVC

Период времени по умолчанию — последние 12 месяцев.

Чтобы просмотреть подробный журнал всех изменений, включая изменения, внесенные более года назад, выберите "Показать все изменения файла":

Show all code changes

Откроется окно Журнал:

History window for all code changes

Если ваши файлы хранятся в репозитории Git и вы выбираете индикатор изменений на уровне элемента кода, отображается следующее:

CodeLens: Get change history for your code in Git

Индикаторы уровня файлов

Просмотрите изменения для всего файла на индикаторах уровня файла в нижней части окна:

CodeLens: Get code file details

Примечание.

Индикаторы на уровне файла недоступны для файлов C# и Visual Basic.

Чтобы получить дополнительные сведения об изменении, щелкните этот элемент правой кнопкой мыши. В зависимости от того, используете ли вы TFVC или Git, существуют варианты сравнения версий файла, просмотра сведений и отслеживания набора изменений, получения выбранной версии файла и отправки электронной почты автору этого изменения. Некоторые из этих сведений отображаются в Team Explorer в Visual Studio 2019 версии 16.7 и более ранних версий. В Visual Studio 2019 версии 16.8 и более поздних версиях эти сведения отображаются в Git Changes.

Вы также можете увидеть, кто изменил код с течением времени, что поможет вам найти закономерности в изменениях вашей команды и оценить их влияние.

CodeLens: See code changes history as a graph

Поиск изменений в текущем подразделении

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

CodeLens: Find changes in your current branch

Можно узнать, сколько пользователей вносили изменения в код и сколько изменений было сделано в основной ветви, нажав ALT+6:

CodeLens: Find how many changes in your branch

Поиск разветвления кода

Чтобы определить, когда ваш код был разделен на ветви, перейдите к коду в дочерней ветви. Затем выберите индикатор изменений (или нажмите клавиши ALT+6):

CodeLens: Find when your code was branched

Поиск входящих изменений от других подразделений

CodeLens: Find code changes in other branches

Вы можете просмотреть входящие изменения. В примере, изображенном на рисунке ниже, была исправлена ошибка в ветви "Dev":

CodeLens: Change checked into another branch

Вы можете просмотреть это изменение, не покидая текущей ветви ("Main"):

CodeLens: See incoming change from another branch

Поиск объединения изменений

Вы можете просмотреть слияния изменений, поэтому можно определить, какие изменения были добавлены в вашу ветвь:

CodeLens - Find when changes got merged

Например, код в ветви "Main" теперь содержит исправление ошибки из ветви "Dev":

CodeLens - Merged changes between branches

Сравнение входящего изменения с локальной версией

Сравните входящее изменение с локальной версией, нажав сочетание клавиш SHIFT+F10 или дважды щелкнув набор изменений.

CodeLens: Compare incoming change with local

Значки ветвей

Значок в столбце Ветвь показывает связь с ветвью, в которой вы работаете.

Значок Откуда пришли изменения:
CodeLens: Change from current branch icon Текущее подразделение
CodeLens: Change from parent branch icon Родительское подразделение
CodeLens: Change from child branch icon Дочернее подразделение
CodeLens: Change from peer branch icon Одноранговое подразделение
CodeLens: Change from branch further away icon Подразделение, отличное от родительского, дочернего или однорангового
CodeLens: Merge from parent icon Слияние с данными от родительского подразделения с дочерним подразделением
CodeLens: Merge from child branch icon Слияние с данными от дочернего подразделения с родительским подразделением
CodeLens: Merge from unrelated branch icon Слияние с данными от несвязанного подразделения (слияние без базовой версии)

Связанные рабочие элементы в Visual Studio 2019

Найдите связанные рабочие элементы, выбрав индикатор рабочие элементы или нажав ALT+8.

CodeLens - Find work items for specific code

Обзоры связанного кода в Visual Studio 2019

Найдите связанные проверки кода, выбрав индикатор проверки. Чтобы перемещаться по индикаторам с помощью клавиатуры, при нажатой клавише ALT нажимайте СТРЕЛКУ ВЛЕВО или СТРЕЛКУ ВПРАВО.

CodeLens - View code review requests

Связанные ошибки в Visual Studio 2019

Найдите связанные ошибки, выбрав индикатор ошибки или нажав ALT+7.

CodeLens - Find bugs linked to changesets

Обратитесь к владельцу элемента в Visual Studio 2019

Найдите автора элемента, выбрав индикатор авторы или нажав ALT+5.

Contact the owner of an item

Откройте контекстное меню элемента, чтобы увидеть параметры контакта. Если вы установили Teams, вы можете увидеть параметры, аналогичные приведенным на следующем снимке экрана:

Contact options for an item

Связанные модульные тесты в Visual Studio 2019

Вы можете узнать, какие имеются модульные тесты для вашего кода C# или Visual Basic, не открывая обозреватель тестов.

  1. Перейдите к коду приложения, содержащему связанный код модульного теста.

  2. Если вы еще не сделали этого, создайте приложение для загрузки индикаторов тестирования CodeLens.

  3. Просмотрите тесты для кода, нажав сочетание клавиш ALT+3.

    CodeLens - Choose test status in code editor

  4. Если вы видите значок warning iconпредупреждения, тесты еще не выполняются, поэтому запустите их.

    CodeLens - View unit tests not run yet

  5. Чтобы просмотреть определение теста, откройте файл кода в редакторе, дважды щелкнув элемент теста в окне индикаторов CodeLens.

    CodeLens - Go to unit test definition

  6. Чтобы просмотреть результаты теста, выберите индикатор состояния теста (test failed iconили) или test passed iconнажмите клавиши ALT+1.

    CodeLens - See unit test result

  7. Чтобы увидеть, сколько пользователей изменяло данный тест, кто именно изменял тест или сколько изменений было внесено в тест, найдите журнал кода и связанные элементы.

Сочетания клавиш в Visual Studio 2019

Чтобы выбрать индикатор с помощью клавиатуры, нажмите и удерживайте клавишу ALT для отображения номеров индикаторов, а затем нажмите цифру с номером индикатора, который необходимо выбрать.

Keyboard access numbers

Примечание.

Чтобы выбрать индикатор проверки, удерживайте нажатой клавишу ALT и нажимайте клавиши со стрелками влево и вправо для перехода.

Вопрос и A для CodeLens в Visual Studio 2019

Вопрос: Разделы справки отключить CodeLens или включить или выбрать индикаторы для просмотра?

Ответ. Включать и выключать можно все индикаторы, кроме индикатора ссылок. Последовательно выберите пункты Сервис>Параметры>Текстовый редактор>Все языки>CodeLens.

Если индикаторы включены, параметры CodeLens можно также открыть из индикаторов.

CodeLens - Turn indicators off or on

Индикаторы CodeLens уровня файла включаются и отключаются с помощью значка шеврона в нижней части окна редактора.

Turn file-level indicators on and off

Вопрос. Где находится CodeLens?

Ответ. CodeLens отображается в коде C# и Visual Basic на уровне метода, класса, индексатора и свойства. Для всех других типов файлов CodeLens отображается на уровне файла.

  • Включите CodeLens. Последовательно выберите пункты Сервис>Параметры>Текстовый редактор>Все языки>CodeLens.

  • Индикаторы, связанные с DevOps, отображаются, только когда рабочие элементы связаны с кодом и имеются разрешения на открытие связанных рабочих элементов. Убедитесь в наличии разрешений члена команды.

  • Индикаторы модульных тестов не отображаются, если в коде приложения отсутствуют модульные тесты. Индикаторы состояния теста отображаются автоматически в тестовых проектах. Если известно, что код приложения имеет модульные тесты, но индикаторы тестов не отображаются, попробуйте выполнить сборку решения (CTRL+SHIFT+B).

Совет

CodeLens доступен в версии сообщества Visual Studio Community, однако в этой версии индикаторы управления source control недоступны.

Вопрос: Почему я не вижу сведения рабочего элемента для фиксации?

Ответ. Это может произойти, так как CodeLens не может найти рабочие элементы в Azure Boards. Проверьте, что вы подключены к проекту, который имеет эти рабочие элементы, и что имеются разрешения для просмотра этих рабочих элементов. Сведения о рабочем элементе также могут не отображаться, если описание фиксации содержит неверные сведения об идентификаторах рабочих элементов в Azure Boards.

Вопрос. Как изменить шрифт и цвет CodeLens?

Ответ. Последовательно выберите пункты Сервис>Параметры>Среда>Шрифты и цвета.

CodeLens - Change font and color settings

Для использования клавиатуры выполните следующие действия.

  1. Нажмите ALT+T+O, чтобы открыть диалоговое окно Параметры.

  2. Нажмите клавишу СТРЕЛКА ВВЕРХ или СТРЕЛКА ВНИЗ , чтобы перейти к узлу Среда , а затем нажмите клавишу СТРЕЛКА ВЛЕВО , чтобы развернуть узел.

  3. Нажмите клавишу СТРЕЛКА ВНИЗ , чтобы перейти к пункту Шрифты и цвета.

  4. Нажмите клавишу TAB, чтобы перейти к списку Параметры для, после чего нажмите клавишу СТРЕЛКА ВНИЗ, чтобы выбрать CodeLens.

В. Можно ли переместить HUD-элемент CodeLens?

Ответ. Да, выберите Dock icon закрепление CodeLens в качестве окна.

Dock button in CodeLens indicator window

Docked CodeLens References window

В. Как обновить индикаторы?

Ответ. Это зависит от индикатора.

  • Ссылки: этот индикатор обновляется автоматически при изменении кода. Если индикатор Ссылки закреплен в отдельном окне, его можно обновить, нажав на Обновить:

    Refresh button in CodeLens References

  • Команда: эти индикаторы можно обновить, выбрав Обновить командные индикаторы CodeLens из контекстного меню:

    Refresh CodeLens Team Indicators menu item

  • Тест: найдите модульные тесты для кода, чтобы обновить индикатор Тест.

Вопрос. Что такое "Локальная версия"?

Ответ. Стрелка Локальная версия указывает на последний набор изменений в локальной версии файла. Если на сервере находятся более новые наборы изменений, они отображаются над или под стрелкой Локальная версия в зависимости от порядка сортировки наборов изменений.

Вопрос. Мои индикаторы тестов CodeLens больше не отображаются в файле, когда я впервые открываю решение. Как их загрузить?

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