Поиск изменений кода и других журналов с помощью CodeLens
С помощью CodeLens вы можете сосредоточиться на работе, пока вы узнаете, что произошло с кодом, не выходя из редактора. Ссылки на фрагмент кода, изменения кода, связанные ошибки, рабочие элементы Azure DevOps, проверки кода и модульные тесты.
Примечание.
CodeLens доступен в выпуске Community Visual Studio; Однако индикаторы системы управления версиями недоступны в этом выпуске.
CodeLens может показать, где и как в решении используются отдельные части кода.
Чтобы выбрать, какие индикаторы должны отображаться, или чтобы включить или выключить средство CodeLens, последовательно выберите пункты Инструменты>Параметры>Текстовый редактор>Все языки>CodeLens.
Поиск ссылок на код
Можно находить ссылки в коде Visual Basic или C#. Это делается следующим образом.
В редакторе кода выберите индикатор ссылок или нажмите клавиши ALT+2.
Примечание.
Если индикатор отображает 0 ссылок, у вас нет ссылок из кода C# или Visual Basic. Однако в других элементах, таких как XAML и .aspx файлы, могут быть ссылки.
Чтобы просмотреть код ссылки, наведите указатель мыши на ссылку в списке.
Чтобы открыть файл, который содержит ссылку, дважды щелкните эту ссылку.
Карты кода
Чтобы просмотреть отношения между этим кодом и его ссылками, создайте карту кода. В контекстном меню карты кода выберите Показать все ссылки.
Поиск изменений в коде
Изучите журнал кода, чтобы узнать, что случилось. Можно также изучить изменения до их внедрения в ваш код, чтобы понять, как изменения в других ветвях могут повлиять на него.
Необходимые компоненты:
Visual Studio Enterprise или Visual Studio Professional
Git или Azure DevOps Server (ранее Team Foundation Server) или система управления версиями Team Foundation
Для кода на 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, существуют варианты сравнения версий файла, просмотра сведений и отслеживания набора изменений, получения выбранной версии файла и отправки электронной почты автору этого изменения. Некоторые из этих сведений отображаются в Team Explorer, если она включена; в противном случае эти сведения отображаются на вкладке "Изменения Git", а также могут отображаться на горизонтальной полосе прокрутки в нижней части редактора.
Вы также можете увидеть, кто изменил код с течением времени, что поможет вам найти закономерности в изменениях вашей команды и оценить их влияние.
Начиная с Visual Studio 2022 версии 17.12 (предварительная версия 2) можно отображать или скрывать индикаторы уровня файлов на горизонтальной полосе прокрутки редактора. Чтобы скрыть индикаторы, откройте расширенный текстовый редактор> параметров > инструментов > и отключите параметр индикатора "Показать уровень файла CodeLens". Этот параметр влияет на видимость типов файлов, имеющих элемент управления CodeLens на нижней панели прокрутки редактора, например XAML, HTML и CSS, и не влияет на файлы, содержащие встроенные CodeLens.
Поиск изменений в текущем подразделении
У вашей команды может быть несколько ветвей, например основная ветвь и дочерняя ветвь разработки, чтобы снизить риск нарушения стабильного кода. Вы можете узнать, сколько людей изменило код и сколько изменений было внесены в основную ветвь, нажав клавиши ALT+6.
Поиск разветвления кода
Чтобы определить, когда ваш код был разделен на ветви, перейдите к коду в дочерней ветви. Затем выберите индикатор изменений (или нажмите клавиши ALT+6).
Поиск входящих изменений от других подразделений
Вы можете просмотреть входящие изменения. И вам не нужно оставлять текущую ветвь для просмотра изменений.
Поиск объединения изменений
Вы можете увидеть, когда изменения были объединены, чтобы определить, какие изменения включены в ветвь.
Сравнение входящего изменения с локальной версией
Чтобы сравнить входящие изменения с локальной версией, дважды щелкните набор изменений или нажмите клавиши SHIFT+F10.
Значки ветвей
Значок в столбце Ветвь показывает связь с ветвью, в которой вы работаете.
Значок | Откуда пришли изменения: |
---|---|
Текущее подразделение | |
Родительское подразделение | |
Дочернее подразделение | |
Одноранговое подразделение | |
Подразделение, отличное от родительского, дочернего или однорангового | |
Слияние с данными от родительского подразделения с дочерним подразделением | |
Слияние с данными от дочернего подразделения с родительским подразделением | |
Слияние с данными от несвязанного подразделения (слияние без базовой версии) |
Связанные рабочие элементы
Найдите связанные рабочие элементы, выбрав индикатор рабочие элементы или нажав ALT+8.
Связанные проверки кода
Найдите связанные проверки кода, выбрав индикатор проверки. Чтобы перемещаться по индикаторам с помощью клавиатуры, при нажатой клавише ALT нажимайте СТРЕЛКУ ВЛЕВО или СТРЕЛКУ ВПРАВО.
Связанные ошибки
Найдите связанные ошибки, выбрав индикатор ошибки или нажав ALT+7.
Обращение к владельцу элемента
Найдите автора элемента, выбрав индикатор авторы или нажав ALT+5.
Вы также можете открыть контекстное меню для элемента, чтобы просмотреть параметры контакта. (Если вы установили Teams, у вас есть дополнительные возможности обмена данными.)
Связанные модульные тесты
Вы можете узнать, какие имеются модульные тесты для вашего кода C# или Visual Basic, не открывая обозреватель тестов.
Перейдите к коду приложения, содержащему связанный код модульного теста.
Если вы еще не сделали этого, создайте приложение для загрузки индикаторов тестирования CodeLens.
Просмотрите тесты для кода, нажав сочетание клавиш ALT+3.
Если вы видите значок предупреждения, тесты еще не выполняются, поэтому запустите их.
Чтобы просмотреть определение теста, откройте файл кода в редакторе, дважды щелкнув элемент теста в окне индикаторов CodeLens.
Чтобы просмотреть результаты теста, выберите индикатор состояния теста (или) или нажмите клавиши ALT+1.
Чтобы увидеть, сколько пользователей изменяло данный тест, кто именно изменял тест или сколько изменений было внесено в тест, найдите журнал кода и связанные элементы.
Сочетания клавиш
Чтобы выбрать индикатор с помощью клавиатуры, нажмите и удерживайте клавишу 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?
Ответ. Последовательно выберите пункты Сервис>Параметры>Среда>Шрифты и цвета.
Для использования клавиатуры выполните следующие действия.
Нажмите ALT+T+O, чтобы открыть диалоговое окно Параметры.
Нажмите клавишу СТРЕЛКА ВВЕРХ или СТРЕЛКА ВНИЗ , чтобы перейти к узлу Среда , а затем нажмите клавишу СТРЕЛКА ВЛЕВО , чтобы развернуть узел.
Нажмите клавишу СТРЕЛКА ВНИЗ , чтобы перейти к пункту Шрифты и цвета.
Нажмите клавишу TAB, чтобы перейти к списку Параметры для, после чего нажмите клавишу СТРЕЛКА ВНИЗ, чтобы выбрать CodeLens.
В. Можно ли переместить HUD-элемент CodeLens?
Ответ. Да, выберите закрепление CodeLens в качестве окна.
В. Как обновить индикаторы?
Ответ. Это зависит от индикатора.
Ссылки: этот индикатор обновляется автоматически при изменении кода. Если индикатор ссылок закреплен в отдельном окне, обновите индикатор, нажав кнопку "Обновить".
Команда. Обновите эти индикаторы, выбрав "Обновить индикаторы команды CodeLens" в меню правой кнопкой мыши.
Тест: найдите модульные тесты для кода, чтобы обновить индикатор Тест.
Вопрос. Что такое "Локальная версия"?
Ответ. Стрелка Локальная версия указывает на последний набор изменений в локальной версии файла. Если на сервере находятся более новые наборы изменений, они отображаются над или под стрелкой Локальная версия в зависимости от порядка сортировки наборов изменений.
Вопрос. Мои индикаторы тестов CodeLens больше не отображаются в файле, когда я впервые открываю решение. Как их загрузить?
Ответ. Перестройте проект, чтобы индикаторы тестов CodeLens загружались в файл. Для повышения производительности Visual Studio больше не получает сведения об источнике для индикаторов тестов при загрузке файлов кода. Индикаторы тестов загружаются после сборки или при переходе к тесту двойным щелчком в обозревателе тестов.
CodeLens позволяет сосредоточиться на работе, пока вы узнаете, что произошло с кодом, не выходя из редактора. Вы можете найти ссылки на фрагмент кода, изменения кода, связанные ошибки, рабочие элементы, проверки кода и модульные тесты.
Примечание.
CodeLens доступен в версии сообщества Visual Studio Community, однако в этой версии индикаторы управления source control недоступны.
Посмотрите, где и как отдельные части вашего кода используются в решении.
Сообщите рабочей группе об изменениях в коде, не выходя из редактора.
Чтобы выбрать, какие индикаторы должны отображаться, или чтобы включить или выключить средство CodeLens, последовательно выберите пункты Инструменты>Параметры>Текстовый редактор>Все языки>CodeLens.
Поиск ссылок на код в Visual Studio 2019
Можно находить ссылки в коде Visual Basic или C#.
Выберите индикатор ссылок или нажмите ALT+2.
Примечание.
Если в индикаторе отображается 0 ссылок, это значит, что ссылки из кода C# или Visual Basic отсутствуют. Однако могут существовать ссылки из других элементов, таких как XAML- и ASPX-файлы.
Чтобы просмотреть код ссылки, наведите указатель мыши на ссылку в списке.
Чтобы открыть файл, который содержит ссылку, дважды щелкните эту ссылку.
Карты кода
Чтобы просмотреть отношения между этим кодом и его ссылками, создайте карту кода. В контекстном меню карты кода выберите Показать все ссылки.
Поиск изменений в коде в Visual Studio 2019
Изучите журнал кода, чтобы узнать, что случилось. Можно также изучить изменения до их внедрения в ваш код, чтобы понять, как изменения в других ветвях могут повлиять на него.
Необходимые компоненты:
Visual Studio Enterprise или Visual Studio Professional
Git или Azure DevOps Server (ранее Team Foundation Server) или система управления версиями Team Foundation
Для кода на 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, существуют варианты сравнения версий файла, просмотра сведений и отслеживания набора изменений, получения выбранной версии файла и отправки электронной почты автору этого изменения. Некоторые из этих сведений отображаются в Team Explorer в Visual Studio 2019 версии 16.7 и более ранних версий. В Visual Studio 2019 версии 16.8 и более поздних версиях эти сведения отображаются в Git Changes.
Вы также можете увидеть, кто изменил код с течением времени, что поможет вам найти закономерности в изменениях вашей команды и оценить их влияние.
Поиск изменений в текущем подразделении
У вашей команды может быть несколько ветвей, например основная ветвь и дочерняя ветвь разработки, чтобы снизить риск нарушения стабильного кода.
Можно узнать, сколько пользователей вносили изменения в код и сколько изменений было сделано в основной ветви, нажав ALT+6:
Поиск разветвления кода
Чтобы определить, когда ваш код был разделен на ветви, перейдите к коду в дочерней ветви. Затем выберите индикатор изменений (или нажмите клавиши ALT+6):
Поиск входящих изменений от других подразделений
Вы можете просмотреть входящие изменения. В примере, изображенном на рисунке ниже, была исправлена ошибка в ветви "Dev":
Вы можете просмотреть это изменение, не покидая текущей ветви ("Main"):
Поиск объединения изменений
Вы можете просмотреть слияния изменений, поэтому можно определить, какие изменения были добавлены в вашу ветвь:
Например, код в ветви "Main" теперь содержит исправление ошибки из ветви "Dev":
Сравнение входящего изменения с локальной версией
Сравните входящее изменение с локальной версией, нажав сочетание клавиш SHIFT+F10 или дважды щелкнув набор изменений.
Значки ветвей
Значок в столбце Ветвь показывает связь с ветвью, в которой вы работаете.
Значок | Откуда пришли изменения: |
---|---|
Текущее подразделение | |
Родительское подразделение | |
Дочернее подразделение | |
Одноранговое подразделение | |
Подразделение, отличное от родительского, дочернего или однорангового | |
Слияние с данными от родительского подразделения с дочерним подразделением | |
Слияние с данными от дочернего подразделения с родительским подразделением | |
Слияние с данными от несвязанного подразделения (слияние без базовой версии) |
Связанные рабочие элементы в Visual Studio 2019
Найдите связанные рабочие элементы, выбрав индикатор рабочие элементы или нажав ALT+8.
Обзоры связанного кода в Visual Studio 2019
Найдите связанные проверки кода, выбрав индикатор проверки. Чтобы перемещаться по индикаторам с помощью клавиатуры, при нажатой клавише ALT нажимайте СТРЕЛКУ ВЛЕВО или СТРЕЛКУ ВПРАВО.
Связанные ошибки в Visual Studio 2019
Найдите связанные ошибки, выбрав индикатор ошибки или нажав ALT+7.
Обратитесь к владельцу элемента в Visual Studio 2019
Найдите автора элемента, выбрав индикатор авторы или нажав ALT+5.
Откройте контекстное меню элемента, чтобы увидеть параметры контакта. Если вы установили Teams, вы можете увидеть параметры, аналогичные приведенным на следующем снимке экрана:
Связанные модульные тесты в Visual Studio 2019
Вы можете узнать, какие имеются модульные тесты для вашего кода C# или Visual Basic, не открывая обозреватель тестов.
Перейдите к коду приложения, содержащему связанный код модульного теста.
Если вы еще не сделали этого, создайте приложение для загрузки индикаторов тестирования CodeLens.
Просмотрите тесты для кода, нажав сочетание клавиш ALT+3.
Если вы видите значок предупреждения, тесты еще не выполняются, поэтому запустите их.
Чтобы просмотреть определение теста, откройте файл кода в редакторе, дважды щелкнув элемент теста в окне индикаторов CodeLens.
Чтобы просмотреть результаты теста, выберите индикатор состояния теста (или) или нажмите клавиши ALT+1.
Чтобы увидеть, сколько пользователей изменяло данный тест, кто именно изменял тест или сколько изменений было внесено в тест, найдите журнал кода и связанные элементы.
Сочетания клавиш в Visual Studio 2019
Чтобы выбрать индикатор с помощью клавиатуры, нажмите и удерживайте клавишу ALT для отображения номеров индикаторов, а затем нажмите цифру с номером индикатора, который необходимо выбрать.
Примечание.
Чтобы выбрать индикатор проверки, удерживайте нажатой клавишу ALT и нажимайте клавиши со стрелками влево и вправо для перехода.
Вопрос и A для CodeLens в Visual Studio 2019
Вопрос: Разделы справки отключить CodeLens или включить или выбрать индикаторы для просмотра?
Ответ. Включать и выключать можно все индикаторы, кроме индикатора ссылок. Последовательно выберите пункты Сервис>Параметры>Текстовый редактор>Все языки>CodeLens.
Если индикаторы включены, параметры CodeLens можно также открыть из индикаторов.
Индикаторы CodeLens уровня файла включаются и отключаются с помощью значка шеврона в нижней части окна редактора.
Вопрос. Где находится CodeLens?
Ответ. CodeLens отображается в коде C# и Visual Basic на уровне метода, класса, индексатора и свойства. Для всех других типов файлов CodeLens отображается на уровне файла.
Включите CodeLens. Последовательно выберите пункты Сервис>Параметры>Текстовый редактор>Все языки>CodeLens.
Индикаторы, связанные с DevOps, отображаются, только когда рабочие элементы связаны с кодом и имеются разрешения на открытие связанных рабочих элементов. Убедитесь в наличии разрешений члена команды.
Индикаторы модульных тестов не отображаются, если в коде приложения отсутствуют модульные тесты. Индикаторы состояния теста отображаются автоматически в тестовых проектах. Если известно, что код приложения имеет модульные тесты, но индикаторы тестов не отображаются, попробуйте выполнить сборку решения (CTRL+SHIFT+B).
Совет
CodeLens доступен в версии сообщества Visual Studio Community, однако в этой версии индикаторы управления source control недоступны.
Вопрос: Почему я не вижу сведения рабочего элемента для фиксации?
Ответ. Это может произойти, так как CodeLens не может найти рабочие элементы в Azure Boards. Проверьте, что вы подключены к проекту, который имеет эти рабочие элементы, и что имеются разрешения для просмотра этих рабочих элементов. Сведения о рабочем элементе также могут не отображаться, если описание фиксации содержит неверные сведения об идентификаторах рабочих элементов в Azure Boards.
Вопрос. Как изменить шрифт и цвет CodeLens?
Ответ. Последовательно выберите пункты Сервис>Параметры>Среда>Шрифты и цвета.
Для использования клавиатуры выполните следующие действия.
Нажмите ALT+T+O, чтобы открыть диалоговое окно Параметры.
Нажмите клавишу СТРЕЛКА ВВЕРХ или СТРЕЛКА ВНИЗ , чтобы перейти к узлу Среда , а затем нажмите клавишу СТРЕЛКА ВЛЕВО , чтобы развернуть узел.
Нажмите клавишу СТРЕЛКА ВНИЗ , чтобы перейти к пункту Шрифты и цвета.
Нажмите клавишу TAB, чтобы перейти к списку Параметры для, после чего нажмите клавишу СТРЕЛКА ВНИЗ, чтобы выбрать CodeLens.
В. Можно ли переместить HUD-элемент CodeLens?
Ответ. Да, выберите закрепление CodeLens в качестве окна.
В. Как обновить индикаторы?
Ответ. Это зависит от индикатора.
Ссылки: этот индикатор обновляется автоматически при изменении кода. Если индикатор Ссылки закреплен в отдельном окне, его можно обновить, нажав на Обновить:
Команда: эти индикаторы можно обновить, выбрав Обновить командные индикаторы CodeLens из контекстного меню:
Тест: найдите модульные тесты для кода, чтобы обновить индикатор Тест.
Вопрос. Что такое "Локальная версия"?
Ответ. Стрелка Локальная версия указывает на последний набор изменений в локальной версии файла. Если на сервере находятся более новые наборы изменений, они отображаются над или под стрелкой Локальная версия в зависимости от порядка сортировки наборов изменений.
Вопрос. Мои индикаторы тестов CodeLens больше не отображаются в файле, когда я впервые открываю решение. Как их загрузить?
Ответ. Перестройте проект, чтобы индикаторы тестов CodeLens загружались в файл. Для повышения производительности Visual Studio больше не получает сведения об источнике для индикаторов тестов при загрузке файлов кода. Индикаторы тестов загружаются после сборки или при переходе к тесту двойным щелчком в обозревателе тестов.
Связанный контент
- Документация по управлению версиями Visual Studio.
- Возможности редактора кода