Znajdowanie zmian kodu i innych historii za pomocą funkcji CodeLens

Program Visual Studio CodeLens pomaga skoncentrować się na pracy, gdy dowiesz się, co się stało z kodem — wszystko bez opuszczania edytora kodu interaktywnego środowiska projektowego (IDE). Możesz znaleźć odwołania do fragmentu kodu, zmiany w swoim kodzie, powiązane usterki, elementy robocze Azure DevOps, przeglądy kodu i testy jednostkowe.

Notatka

Funkcja CodeLens jest dostępna w wersji Community programu Visual Studio, ale wskaźniki kontroli źródła nie są dostępne w tej wersji.

Funkcja CodeLens może pokazać, gdzie i w jaki sposób poszczególne części kodu są używane w rozwiązaniu:

Wyświetl szczegóły dotyczące zmian w kodzie użytkownika, a następnie kliknij prawym przyciskiem myszy i wybierz opcję Wyślij wiadomość e-mail do <użytkownika>, aby skontaktować się z użytkownikami bez wychodzenia z edytora kodu.

Aby wybrać wskaźniki, które chcesz wyświetlić, lub włączyć i wyłączyć funkcję CodeLens, przejdź do Narzędzia>Opcje>Edytor tekstu>Wszystkie języki>CodeLens.

Skróty klawiaturowe w programie Visual Studio 2022

Wiele operacji opisanych w poniższych sekcjach jest dostępnych przy użyciu skrótów klawiaturowych w oknie edytora kodu programu Visual Studio.

Aby użyć klawiatury do wybierania wskaźników, naciśnij i przytrzymaj Alt, aby wyświetlić powiązane liczby, a następnie wybierz numer na klawiaturze, który odpowiada żądanemu wskaźnikowi:

Notatka

Aby wybrać wskaźnik przeglądów, wybierz Alt podczas korzystania ze strzałki w lewo i strzałki w prawo do przeglądania.

Znajdowanie odwołań do kodu

Odwołania można znaleźć w kodzie języka C# albo Visual Basic.

1. W edytorze kodu wybierz wskaźnik referencji lub użyj skrótu klawiaturowego Alt+2:

   

   Notatka

   Jeśli wskaźnik pokazuje 0 odwołań, nie masz żadnych odwołań z kodu C# lub Visual Basic. Jednak w innych elementach projektu mogą występować odwołania, takie jak .xaml i pliki .aspx.

2. Aby wyświetlić kod odwołujący się, umieść kursor na odwołaniu na liście.

   

3. Aby otworzyć plik zawierający odwołanie, kliknij dwukrotnie odwołanie.

Tworzenie mapy kodu

Aby wyświetlić relacje między kodem i jego odwołaniami, możesz utworzyć mapę kodu. Na pasku narzędzi mapy kodu rozwiń menu rozwijane Pokaż powiązane i wybierz pozycję Znajdź wszystkie odwołania:

Znajdowanie zmian w kodzie

Sprawdź historię kodu, aby dowiedzieć się, co się stało z kodem. Możesz też przejrzeć zmiany przed ich scaleniem z kodem, aby lepiej zrozumieć, jak zmiany w innych gałęziach mogą mieć wpływ na kod.

Potrzebujesz:

• Visual Studio Enterprise lub Visual Studio Professional

• Git lub Azure DevOps Server (dawniej Team Foundation Server) lub Kontrola wersji Team Foundation (TFVC)

W przypadku języka C# (.cs) lub Visual Basic (.vb) kodu przechowywanego z TFVC lub Git, szczegóły CodeLens są widoczne na poziomie klasy i metody (Wskaźniki na poziomie kodu) w pliku.

W przypadku typów plików innych niż .cs lub .vbopcja Pokaż wskaźnik kodlens na poziomie pliku umożliwia wyświetlenie szczegółów funkcji CodeLens dla całego pliku. Wskaźniki na poziomie pliku są wyświetlane w dolnej części pliku w edytorze kodu:

Wskaźniki na poziomie elementu kodu

Wskaźniki na poziomie elementu kodu pozwalają zobaczyć, kto zmienił kod i jakie zmiany zostały wprowadzone. Wskaźniki na poziomie elementu kodu są dostępne dla języka C# i języka Visual Basic.

Można również wyświetlić historię zmian, korzystając z TFVC lub Azure DevOps Services.

Domyślny okres to ostatnie 12 miesięcy (jeden rok).

Aby wyświetlić szczegółową historię wszystkich zmian, w tym te zmiany z ponad roku temu, wybierz pozycję Pokaż wszystkie zmiany plików, co spowoduje otwarcie okna historia . W oknie Historia możesz wyświetlić wszystkie pliki, które znajdują się w repozytorium Git, i wybrać wskaźnik zmian na poziomie elementu kodu, aby uzyskać więcej szczegółów:

Wskaźniki na poziomie pliku

Można również znaleźć zmiany dla całego pliku za pomocą wskaźników na poziomie pliku w dolnej części okna edytora kodu.

Notatka

Wskaźniki na poziomie pliku nie są dostępne dla plików C# i Visual Basic.

Aby uzyskać więcej szczegółów na temat zmiany, kliknij prawym przyciskiem myszy element. W zależności od tego, czy używasz TFVC, albo Gita, dostępne są opcje porównywania wersji pliku, wyświetlania szczegółów i śledzenia zestawu zmian, pobierania wybranej wersji pliku oraz wysyłania e-maila do autora tej zmiany. Niektóre szczegóły są wyświetlane w programie Team Explorer po włączeniu; w przeciwnym razie szczegóły zostaną wyświetlone w okienku Zmiany usługi Git. Możliwe, że zobaczysz szczegóły na pasku przewijania poziomego na dole edytora kodu.

Wskaźniki pokazują, kto zmienił kod w czasie, co może pomóc w znalezieniu wzorców w zmianach zespołu i ocenieniu ich wpływu:

Począwszy od Visual Studio 2022 w wersji 17.12 Preview 2, możesz pokazywać lub ukrywać wskaźniki na poziomie plików na poziomym pasku przewijania edytora kodu, korzystając z opcji Narzędzia > Opcje > Edytor tekstu > Zaawansowane>Pokaż wskaźnik CodeLens na poziomie plików. Ta opcja aktualizuje widoczność typów plików, które implementują kontrolkę CodeLens na poziomie pliku na dolnym pasku przewijania edytora, takim jak XAML, HTML i CSS. Opcja nie ma wpływu na pliki, które zawierają wbudowany kod CodeLens (C# i VB).

Znajdź zmiany w bieżącej gałęzi

Twój zespół może mieć wiele gałęzi, takich jak gałąź główna i gałąź rozwoju dodatkowego, aby zmniejszyć ryzyko uszkodzenia stabilnego kodu.

Możesz dowiedzieć się, ile współautorów zmieniło kod i ile zmian zostało wprowadzonych w gałęzi głównej, wybierając Alt+0 skrót klawiaturowy

Znajdź, kiedy kod został rozgałęziony

Aby znaleźć, kiedy kod został rozgałęziony, przejdź do kodu w gałęzi podrzędnej. Następnie wybierz wskaźnik zmian ( wybierz Alt+0):

Znajdowanie zmian przychodzących z innych gałęzi

Możesz wyświetlić zmiany przychodzące i nie musisz opuszczać bieżącej gałęzi, aby przejrzeć zmianę.

Znajdowanie, kiedy zmiany zostały scalone

Możesz zobaczyć, kiedy zmiany zostały scalone, dzięki czemu możesz określić, które zmiany są uwzględnione w twojej gałęzi.

Porównanie zmian przychodzących z lokalną wersją

Aby porównać zmianę przychodzącą z lokalną wersją, kliknij dwukrotnie zestaw zmian lub wybierz Shift + F10.

Ikony gałęzi

Ikona w kolumnie Branch wskazuje, w jaki sposób gałąź jest powiązana z gałęzią, w której pracujesz.

Ikona	Zmiana pochodziła z
	Bieżąca gałąź
	Gałąź nadrzędna
	Gałąź podrzędna
	Gałąź równorzędna
	Gałąź oddalona bardziej niż element na poziomie nadrzędnym, podrzędnym lub równorzędnym.
	Scalanie z gałęzi nadrzędnej do gałęzi podrzędnej
	Scalanie z gałęzi podrzędnej do gałęzi nadrzędnej
	Scalanie z niepowiązanej gałęzi (scalanie bezpodstawne)

Połączone elementy robocze

Znajdź połączone elementy robocze, wybierając wskaźnik elementów roboczych lub używając skrótu klawiaturowego Alt+8.

Połączone przeglądy kodu

Znajdź połączone przeglądy kodu, wybierając wskaźnik przeglądów . Aby użyć klawiatury, przytrzymaj Alt, a następnie wybierz strzałkę w lewo lub strzałkę w prawo, aby przeglądać opcje wskaźnika.

Połączone usterki

Znajdź połączone usterki, wybierając wskaźnik usterek lub używając skrótu klawiaturowego Alt + 7.

Skontaktuj się z właścicielem elementu

Znajdź autora elementu, wybierając autorzy wskaźnik lub używając skrótu klawiaturowego Alt + Alt.

Możesz również otworzyć menu skrótów dla elementu, aby wyświetlić opcje kontaktu. (Jeśli masz zainstalowaną aplikację Teams, masz dostępne inne opcje komunikacji).

Skojarzone testy jednostkowe

Możesz odnaleźć testy jednostkowe istniejące dla kodu C# lub Visual Basic bez otwierania Eksploratora testów.

1. Przejdź do kodu aplikacji ze skojarzonym kodem testu jednostkowego .

2. W razie potrzeby skompiluj aplikację, aby załadować wskaźniki testowe CodeLens.

3. Przejrzyj testy kodu za pomocą skrótu klawiaturowego Alt + 3.

4. Jeśli zostanie wyświetlona ikona Ostrzeżenie , testy nie zostały jeszcze uruchomione, więc uruchom je.

5. Aby przejrzeć definicję testu, kliknij dwukrotnie element testu w oknie wskaźnika CodeLens i otwórz plik kodu w edytorze.

6. Aby przejrzeć wyniki testu, wybierz stan testu Niepowodzenie lub wskaźnik passed (wskaźnik lub ) lub użyj skrótu klawiaturowego Alt +1.

7. Aby sprawdzić, ilu współautorów zmieniło ten test, kto zmienił ten test lub ile zmian zostało wprowadzonych w tym teście, znajdź historię swojego kodu i powiązanych elementów.

Q & A

.: Jak wyłączyć lub włączyć funkcję CodeLens lub wybrać wskaźniki do wyświetlenia?

A: Można wyłączyć lub włączyć wskaźniki, z wyjątkiem wskaźnika odwołań. Przejdź do Tools>Options>Text Editor>All Languages>CodeLens.

Po włączeniu wskaźników można również otworzyć opcje CodeLens ze wskaźników. Ponadto można włączyć i wyłączyć wskaźniki poziomu plików CodeLens, używając ikon chevron w dolnej części okna edytora.

.: Gdzie jest CodeLens?

A: CodeLens pojawia się w kodzie C# i Visual Basic na poziomie metody, klasy, indeksatora i właściwości. Funkcja CodeLens jest wyświetlana na poziomie pliku dla wszystkich innych typów plików.

• Upewnij się, że funkcja CodeLens jest włączona. Przejdź do Tools>Options>Text Editor>All Languages>CodeLens.

• Wskaźniki związane z usługą Azure DevOps są wyświetlane tylko wtedy, gdy elementy robocze są połączone z kodem i gdy masz uprawnienia do otwierania połączonych elementów roboczych. Upewnij się, że masz uprawnienia członka zespołu .

• Wskaźniki testów jednostkowych nie są wyświetlane, gdy kod aplikacji nie ma testów jednostkowych. Wskaźniki stanu testu są wyświetlane automatycznie w projektach testowych. Jeśli wiesz, że kod aplikacji ma testy jednostkowe, ale wskaźniki testów nie są wyświetlane, spróbuj sbudować rozwiązanie (Ctrl + Shift + B).

Napiwek

Funkcja CodeLens jest dostępna w programie Visual Studio Community Edition, jednak wskaźniki kontroli źródła nie są dostępne w tej wersji.

Dlaczego nie widzę szczegółów elementu roboczego dotyczącego zatwierdzenia?

A: Ten scenariusz może wystąpić, ponieważ funkcja CodeLens nie może odnaleźć elementów roboczych w usłudze Azure Boards. Sprawdź, czy jesteś połączony z projektem, który zawiera te elementy robocze, oraz czy masz uprawnienia do ich wyświetlania. Szczegóły elementu roboczego mogą również nie być wyświetlane, jeśli opis zatwierdzenia zawiera nieprawidłowe informacje o identyfikatorach elementów roboczych w usłudze Azure Boards.

.: Jak zmienić czcionkę i kolor dla funkcji CodeLens?

A: Przejdź do Narzędzia>Opcje>Środowisko>Czcionki i kolory.

Aby użyć klawiatury:

1. Wybierz Alt + T + O, aby otworzyć okno dialogowe Opcje .

2. Wybierz strzałkę w górę lub strzałkę w dół, aby przejść do węzła środowiska, a następnie wybierz strzałkę w lewo, aby rozwinąć węzeł.

3. Wybierz strzałkę w dół, aby przejść do czcionki i kolory.

4. Wybierz kartę, aby przejść do listy Pokaż ustawienia dla, a następnie wybierz strzałkę w dół, aby wybrać CodeLens.

.: Czy mogę przenieść wyświetlacz head-up CodeLens?

A: Tak, wybierz ikonę Dock, aby zadokować funkcję CodeLens jako okno.

.: Jak odświeżyć wskaźniki?

A: Proces odświeżania różni się w zależności od wskaźnika:

• Odwołania: Ten wskaźnik jest aktualizowany automatycznie po zmianie kodu. Jeśli wskaźnik odwołania jest zadokowany jako osobne okno, odśwież wskaźnik, wybierając pozycję Odśwież.

• Team: Odśwież te wskaźniki, wybierając Odśwież wskaźniki zespołu CodeLens z menu po kliknięciu prawym przyciskiem myszy.

• Test: Znajdź testy jednostkowe dla swojego kodu, aby odświeżyć wskaźnik testowy .

.: Co to jest "wersja lokalna"?

A: strzałka wersji lokalnej wskazuje na najnowszy zestaw zmian w lokalnej wersji pliku. Kiedy serwer zawiera nowsze zestawy zmian, są one wyświetlane przed lub po lokalnej wersji , w zależności od kolejności używanej do sortowania tych zmian.

.: Moje wskaźniki testów CodeLens nie są już wyświetlane w moim pliku po pierwszym otwarciu rozwiązania. Jak mogę je załadować?

A: Odbuduj projekt, aby wskaźniki testowe CodeLens załadowały się w Twoim pliku. Aby zwiększyć wydajność, program Visual Studio nie pobiera już informacji źródłowych dla wskaźników testów podczas ładowania plików kodu. Wskaźniki testów są ładowane po kompilacji lub po dwukrotnym kliknięciu na test w Eksploratorze Testów .

Powiązana zawartość

• Informacje o kontroli wersji usługi Git w programie Visual Studio
• funkcje edytora kodu