Menemukan perubahan kode dan riwayat lain dengan CodeLens

Berlaku untuk:yes Visual Studio noVisual Studio untuk Mac noVisual Studio Code

CodeLens memungkinkan Anda tetap fokus pada pekerjaan Anda sementara Anda mengetahui apa yang terjadi pada kode Anda - tanpa meninggalkan editor. Anda dapat menemukan referensi ke sepotong kode, perubahan pada kode Anda, bug tertaut, item kerja, ulasan kode, dan pengujian unit.

Catatan

CodeLens tersedia di Visual Studio Community edition, namun, indikator kontrol sumber tidak tersedia dalam edisi ini.

Lihat di mana dan bagaimana bagian individual kode Anda digunakan dalam solusi Anda:

CodeLens indicators in the code editor

Hubungi tim Anda tentang perubahan pada kode Anda tanpa meninggalkan editor:

CodeLens - Contact your team

Untuk memilih indikator yang ingin Anda lihat, atau untuk menonaktifkan dan mengaktifkan CodeLens, bukaOpsi>Alat>Editor> TeksSemua Bahasa>CodeLens.

Menemukan referensi ke kode Anda

Anda dapat menemukan referensi dalam kode C# atau Visual Basic.

  1. Pilih indikator referensi atau tekan Alt+2.

    CodeLens references

    Catatan

    Jika indikator menunjukkan 0 referensi, Anda tidak memiliki referensi dari kode C# atau Visual Basic. Namun, mungkin ada referensi dalam item lain seperti file .xaml dan .aspx .

  2. Untuk melihat kode referensi, arahkan mouse ke atas referensi dalam daftar.

    CodeLens - Peek reference

  3. Untuk membuka file yang berisi referensi, klik dua kali referensi.

Peta kode

Untuk melihat hubungan antara kode dan referensinya, buat peta kode. Di menu pintasan peta kode, pilih Perlihatkan Semua Referensi.

CodeLens - References on code map

Menemukan perubahan dalam kode Anda

Periksa riwayat kode Anda untuk mengetahui apa yang terjadi pada kode Anda. Atau, tinjau perubahan sebelum digabungkan ke dalam kode Anda sehingga Anda dapat lebih memahami bagaimana perubahan di cabang lain dapat memengaruhi kode Anda.

Anda memerlukan:

  • Edisi Visual Studio Enterprise atau Professional

  • Layanan Azure DevOps, Team Foundation Server 2013 atau yang lebih baru, atau Git

  • Microsoft Teams atau Skype for Business untuk menghubungi tim Anda dari editor kode

Untuk kode C# atau Visual Basic yang disimpan dengan Team Foundation Version Control (TFVC) atau Git, Anda mendapatkan detail CodeLens di tingkat kelas dan metode (indikator tingkat elemen kode ). Jika repositori Git Anda dihosting di TfGit, Anda juga mendapatkan tautan ke item kerja TFS.

Code element-level indicators

Untuk jenis file selain .cs atau .vb, Anda mendapatkan detail CodeLens untuk seluruh file di satu tempat di bagian bawah jendela (indikator tingkat file ).

File-level CodeLens indicators

Indikator tingkat elemen kode

Indikator tingkat elemen kode memungkinkan Anda melihat siapa yang mengubah kode Anda dan perubahan apa yang mereka buat. Indikator tingkat elemen kode tersedia untuk kode C# dan Visual Basic.

Inilah yang Anda lihat ketika Anda menggunakan Team Foundation Version Control (TFVC) di Team Foundation Server atau Azure DevOps Services:

CodeLens: Get change history for your code in TFVC

Periode waktu default adalah 12 bulan terakhir. Jika kode Anda disimpan di Team Foundation Server, Anda dapat mengubah periode waktu dengan menjalankan perintah TFSConfig dengan perintah CodeIndex dan bendera /indexHistoryPeriod .

Untuk melihat riwayat terperinci dari semua perubahan, termasuk yang berasal dari lebih dari setahun yang lalu, pilih Perlihatkan semua perubahan file:

Show all code changes

Jendela Riwayat terbuka:

History window for all code changes

Saat file Anda berada di repositori Git dan Anda memilih indikator perubahan tingkat elemen kode, inilah yang Anda lihat:

CodeLens: Get change history for your code in Git

Indikator tingkat file

Temukan perubahan untuk seluruh file di indikator tingkat file di bagian bawah jendela:

CodeLens: Get code file details

Catatan

Indikator tingkat file tidak tersedia untuk file C# dan Visual Basic.

Untuk mendapatkan detail selengkapnya tentang perubahan, klik kanan item tersebut. Bergantung pada apakah Anda menggunakan TFVC atau Git, ada opsi untuk membandingkan versi file, melihat detail dan melacak set perubahan, mendapatkan versi file yang dipilih, dan mengirim email kepada penulis perubahan tersebut. Beberapa detail ini muncul di Team Explorer di Visual Studio 2019 versi 16.7 dan yang lebih lama. Di Visual Studio 2019 versi 16.8 dan yang lebih baru, detail ini akan muncul di Perubahan Git.

Anda juga dapat melihat siapa yang mengubah kode Anda dari waktu ke waktu. Ini dapat membantu Anda menemukan pola dalam perubahan tim Anda dan menilai dampaknya.

CodeLens: See code changes history as a graph

Menemukan perubahan di cabang Anda saat ini

Tim Anda mungkin memiliki beberapa cabang, misalnya cabang utama dan cabang pengembangan anak, untuk mengurangi risiko melanggar kode stabil.

CodeLens: Find changes in your current branch

Anda dapat mengetahui berapa banyak orang yang mengubah kode Anda dan berapa banyak perubahan yang dilakukan di cabang utama dengan menekan Alt+6:

CodeLens: Find how many changes in your branch

Temukan kapan kode Anda bercabang

Untuk menemukan kapan kode Anda bercabang, navigasikan ke kode Anda di cabang anak. Kemudian, pilih indikator perubahan atau tekan Alt+6:

CodeLens: Find when your code was branched

Menemukan perubahan masuk dari cabang lain

CodeLens: Find code changes in other branches

Anda dapat melihat perubahan masuk. Dalam cuplikan layar berikut, perbaikan bug dilakukan di cabang "Dev":

CodeLens: Change checked into another branch

Anda dapat meninjau perubahan tanpa meninggalkan cabang Anda saat ini ("Utama"):

CodeLens: See incoming change from another branch

Temukan kapan perubahan digabungkan

Anda dapat melihat kapan perubahan digabungkan, sehingga Anda dapat menentukan perubahan mana yang disertakan dalam cabang Anda:

CodeLens - Find when changes got merged

Misalnya, kode Anda di cabang Utama sekarang memiliki perbaikan bug dari cabang "Dev":

CodeLens - Merged changes between branches

Membandingkan perubahan masuk dengan versi lokal Anda

Bandingkan perubahan masuk dengan versi lokal Anda dengan menekan Shift+F10, atau dengan mengklik dua kali set perubahan.

CodeLens: Compare incoming change with local

Ikon cabang

Ikon di kolom Cabang memberi tahu Anda bagaimana cabang terkait dengan cabang tempat Anda bekerja.

Ikon Perubahan berasal dari:
CodeLens: Change from current branch icon Cabang saat ini
CodeLens: Change from parent branch icon Cabang induk
CodeLens: Change from child branch icon Cabang anak
CodeLens: Change from peer branch icon Cabang serekan
CodeLens: Change from branch further away icon Cabang lebih jauh dari induk, anak, atau serekan
CodeLens: Merge from parent icon Penggabungan dari cabang induk ke cabang anak
CodeLens: Merge from child branch icon Penggabungan dari cabang anak ke cabang induk
CodeLens: Merge from unrelated branch icon Penggabungan dari cabang yang tidak terkait (penggabungan tanpa dasar)

Item kerja tertaut

Temukan item kerja tertaut dengan memilih indikator item kerja atau dengan menekan Alt+8.

CodeLens - Find work items for specific code

Ulasan kode tertaut

Temukan ulasan kode tertaut dengan memilih indikator ulasan . Untuk menggunakan keyboard, tahan tombol Alt lalu tekan Panah kiri atau Panah kanan untuk menavigasi opsi indikator.

CodeLens - View code review requests

Bug tertaut

Temukan bug yang ditautkan dengan memilih indikator bug atau dengan menekan Alt+7.

CodeLens - Find bugs linked to changesets

Hubungi pemilik item

Temukan penulis item dengan memilih indikator penulis atau dengan menekan Alt+5.

Contact the owner of an item

Buka menu pintasan untuk item untuk melihat opsi kontak. Jika Anda memiliki Lync, Skype for Business, atau Teams yang terinstal, Anda akan melihat opsi yang mirip dengan yang ada di cuplikan layar berikut ini:

Contact options for an item

Pengujian unit terkait

Anda dapat menemukan pengujian unit yang ada untuk kode C# atau Visual Basic tanpa membuka Test Explorer.

  1. Buka kode aplikasi yang memiliki kode pengujian unit terkait.

  2. Jika Anda belum melakukannya, buat aplikasi Anda untuk memuat indikator pengujian CodeLens.

  3. Tinjau pengujian untuk kode dengan menekan Alt+3.

    CodeLens - Choose test status in code editor

  4. Jika Anda melihat ikon warning iconperingatan , pengujian belum berjalan, jadi jalankan.

    CodeLens - View unit tests not run yet

  5. Untuk meninjau definisi pengujian, klik dua kali item pengujian di jendela indikator CodeLens untuk membuka file kode di editor.

    CodeLens - Go to unit test definition

  6. Untuk meninjau hasil pengujian, pilih indikator status pengujian (test failed icon atau test passed icon) atau tekan Alt+1.

    CodeLens - See unit test result

  7. Untuk melihat berapa banyak orang yang mengubah pengujian ini, yang mengubah pengujian ini, atau berapa banyak perubahan yang dilakukan pada pengujian ini, temukan riwayat kode dan item tertaut Anda.

Pintasan papan ketik

Untuk menggunakan keyboard untuk memilih indikator, tekan dan tahan tombol Alt untuk menampilkan tombol angka terkait, lalu tekan angka yang sesuai dengan indikator yang ingin Anda pilih.

Keyboard access numbers

Catatan

Untuk memilih indikator tinjauan , tahan Alt saat menggunakan tombol panah kiri dan kanan untuk menavigasi.

Q & A

T: Bagaimana cara menonaktifkan atau mengaktifkan CodeLens atau memilih indikator mana yang akan dilihat?

J: Anda dapat menonaktifkan atau menyalakan indikator, kecuali untuk indikator referensi. BukaOpsi>Alat>Editor> TeksSemua Bahasa>CodeLens.

Saat indikator diaktifkan, Anda juga dapat membuka opsi CodeLens dari indikator.

CodeLens - Turn indicators off or on

Aktifkan dan nonaktifkan indikator tingkat file CodeLens menggunakan ikon chevron di bagian bawah jendela editor.

Turn file-level indicators on and off

T: Di mana CodeLens?

J: CodeLens muncul dalam kode C# dan Visual Basic di tingkat metode, kelas, pengindeks, dan properti. CodeLens muncul di tingkat file untuk semua jenis file lainnya.

  • Pastikan CodeLens diaktifkan. BukaOpsi>Alat>Editor> TeksSemua Bahasa>CodeLens.

  • Jika kode Anda disimpan di TFS, pastikan pengindeksan kode diaktifkan dengan menggunakan perintah CodeIndex dengan perintah Konfigurasi TFS.

  • Indikator terkait DevOps hanya muncul ketika item kerja ditautkan ke kode dan ketika Anda memiliki izin untuk membuka item kerja tertaut. Konfirmasikan bahwa Anda memiliki izin anggota tim.

  • Indikator pengujian unit tidak muncul ketika kode aplikasi tidak memiliki pengujian unit. Indikator status pengujian muncul secara otomatis dalam proyek pengujian. Jika Anda tahu bahwa kode aplikasi Anda memiliki pengujian unit, tetapi indikator pengujian tidak muncul, coba bangun solusi (Ctrl+Shift+B).

Tip

CodeLens tersedia di Visual Studio Community edition, namun, indikator kontrol sumber tidak tersedia dalam edisi ini.

T: Mengapa saya tidak melihat detail item kerja untuk penerapan?

J: Ini mungkin terjadi karena CodeLens tidak dapat menemukan item kerja di Azure Boards atau TFS. Periksa apakah Anda tersambung ke proyek yang memiliki item kerja tersebut, dan Anda memiliki izin untuk melihat item kerja tersebut. Detail item kerja mungkin juga tidak ditampilkan jika deskripsi penerapan memiliki informasi yang salah tentang ID item kerja di Azure Boards atau TFS.

T: Mengapa saya tidak melihat indikator Skype?

J: Indikator Skype tidak muncul jika Anda tidak masuk ke Skype for Business, tidak menginstalnya, atau tidak memiliki konfigurasi yang didukung. Namun, Anda masih dapat mengirim email:

CodeLens - Contact changeset owner by mail

Konfigurasi Skype dan Lync mana yang didukung?

  • Skype for Business (32-bit atau 64-bit)

  • Lync 2010 atau yang lebih baru saja (32-bit atau 64-bit), tetapi bukan Lync Basic 2013 dengan Windows 8.1

CodeLens tidak mendukung instalasi versi Lync atau Skype yang berbeda. Mereka mungkin tidak dilokalkan untuk semua versi Visual Studio yang dilokalkan.

T: Bagaimana cara mengubah font dan warna untuk CodeLens?

J: BukaOpsi>Alat>Font dan WarnaLingkungan>.

CodeLens - Change font and color settings

Untuk menggunakan keyboard:

  1. Tekan Alt+T+O untuk membuka kotak dialog Opsi .

  2. Tekan Panah Atas atau Panah Bawah untuk masuk ke simpul Lingkungan , lalu tekan Panah Kiri untuk memperluas simpul.

  3. Tekan Panah Bawah untuk masuk ke Font dan Warna.

  4. Tekan Tab untuk masuk ke daftar Perlihatkan pengaturan, lalu tekan Panah Bawah untuk memilih CodeLens.

T: Bisakah saya memindahkan tampilan heads-up CodeLens?

J: Ya, pilih Dock icon untuk menambuk CodeLens sebagai jendela.

Dock button in CodeLens indicator window

Docked CodeLens References window

T: Bagaimana cara me-refresh indikator?

J: Ini tergantung pada indikator:

  • Referensi: Indikator ini diperbarui secara otomatis saat kode berubah. Jika indikator Referensi ditampung sebagai jendela terpisah, refresh indikator dengan memilih Refresh:

    Refresh button in CodeLens References

  • Tim: Refresh indikator ini dengan memilih Refresh CodeLens Team Indicators dari menu klik kanan:

    Refresh CodeLens Team Indicators menu item

  • Uji: Temukan pengujian unit untuk kode Anda untuk me-refresh indikator Uji .

T: Apa itu "Versi Lokal"?

J: Panah Versi Lokal menunjuk pada set perubahan terbaru di versi lokal file Anda. Ketika server memiliki set perubahan yang lebih baru, mereka muncul di atas atau di bawah panah Versi Lokal , tergantung pada urutan yang digunakan untuk mengurutkan set perubahan.

T: Bisakah saya mengelola cara CodeLens memproses kode untuk menampilkan riwayat dan item tertaut?

J: Ya. Jika kode Anda berada di TFS, gunakan perintah CodeIndex dengan perintah Konfigurasi TFS.

T: Indikator pengujian CodeLens saya tidak lagi muncul di file saya ketika saya pertama kali membuka solusi saya. Bagaimana cara memuatnya?

J: Bangun kembali proyek Anda untuk mendapatkan indikator pengujian CodeLens untuk dimuat dalam file Anda. Untuk meningkatkan performa, Visual Studio tidak lagi mengambil informasi sumber untuk indikator pengujian saat file kode dimuat. Indikator pengujian dimuat setelah build, atau saat Anda menavigasi ke pengujian dengan mengklik dua kali di Test Explorer.

Lihat juga