Bagikan melalui

Menginstal simbol penelusuran kesalahan untuk penerjemah Python di Visual Studio

Artikel ini menyediakan langkah-langkah untuk mengunduh dan mengintegrasikan simbol penelusuran kesalahan untuk penerjemah Python di Visual Studio.

Untuk memberikan pengalaman penelusuran kesalahan penuh, debugger Python mode campuran di Visual Studio memerlukan simbol debug bagi penerjemah Python untuk mengurai banyak struktur data internal. Simbol penelusuran kesalahan ditentukan dalam file database program (.pdb). Misalnya, pustaka python27.dll memerlukan file simbol python27.pdb , pustaka python36.dll menggunakan file simbol python36.pdb, dan sebagainya. Setiap versi penerjemah juga memasok file simbol untuk berbagai modul.

  • Di Visual Studio 2017 dan yang lebih baru, penerjemah Python 3 dan Anaconda 3 secara otomatis menginstal simbol masing-masing dan Visual Studio menemukan simbol secara otomatis.

  • Di Visual Studio 2015 dan yang lebih lama, atau untuk penerjemah lain, Anda perlu mengunduh simbol secara terpisah lalu mengarahkan Visual Studio ke file.

Saat Visual Studio mendeteksi simbol yang diperlukan hilang, dialog akan meminta Anda untuk mengambil tindakan. Anda biasanya melihat dialog saat memulai sesi debugging mode campuran. Dialog menyertakan tautan dialog Buka pengaturan simbol, yang membuka dialog Opsi Alat>ke tab Simbol Penelusuran Kesalahan>, bersama dengan tautan ke artikel dokumentasi ini.

Cuplikan layar yang memperlihatkan perintah di Visual Studio untuk memberikan simbol debugging yang diperlukan yang hilang.

Prasyarat

Periksa versi interpreter Anda

Simbol berbeda antara build kecil Python dan antara build 32-bit dan 64-bit. Penting untuk mengonfirmasi versi dan build Python Anda untuk memastikan Anda memiliki simbol yang benar untuk penerjemah Anda.

Untuk memeriksa interpreter Python mana yang digunakan:

  1. Di Penjelajah Solusi, perluas simpul Lingkungan Python di bawah proyek Anda.

  2. Temukan nama lingkungan saat ini (ditampilkan dalam huruf tebal).

  3. Klik kanan nama lingkungan dan pilih Buka Prompt Perintah Di Sini.

    Jendela prompt perintah terbuka ke lokasi penginstalan lingkungan saat ini.

  4. Mulai python dengan memasukkan perintah berikut:

    python.exe

    Proses eksekusi menampilkan versi Python yang diinstal dan menunjukkan apakah itu 32-bit atau 64-bit:

    Cuplikan layar yang memperlihatkan cara menggunakan prompt perintah yang dibuka ke lokasi penginstalan lingkungan saat ini untuk mendeteksi versi Python.

Mengunduh Simbol

Langkah-langkah berikut menjelaskan cara mengunduh simbol yang diperlukan untuk penerjemah Python.

  • Untuk Python 3.5 dan yang lebih baru, dapatkan simbol debug melalui alat penginstal Python.

    1. Pilih Penginstalan kustom, lalu pilih Berikutnya.

    2. Pada halaman Opsi Tingkat Lanjut, pilih kotak untuk Unduh simbol penelusuran kesalahan dan Unduh biner debug:

      Cuplikan layar yang memperlihatkan cara memilih simbol debugging dan biner di alat penginstal Python 3.x.

    File simbol (.pdb) terletak di folder penginstalan akar. File simbol untuk modul individual juga ditempatkan di folder DLL .

    Visual Studio menemukan simbol-simbol ini secara otomatis. Tidak ada langkah-langkah lebih lanjut yang diperlukan.

  • Untuk Python 3.4.x dan yang lebih lama, simbol tersedia sebagai file yang dapat .zip diunduh dari distribusi resmi atau dari Enthought Canopy.

    1. Unduh file simbol yang diperlukan.

      Penting

      Pastikan untuk memilih file simbol yang sesuai dengan versi dan build Python yang diinstal (32-bit atau 64-bit).

    2. Ekstrak file simbol ke folder lokal dalam folder Python, seperti Simbol.

    3. Setelah Anda mengekstrak file, langkah selanjutnya adalah Mengarahkan Visual Studio ke simbol.

  • Untuk distribusi Python pihak ketiga lainnya seperti ActiveState Python, hubungi penulis distribusi tersebut dan minta mereka untuk memberi Anda simbol.

    WinPython menggabungkan interpreter Python standar tanpa perubahan. Anda dapat menggunakan simbol dari distribusi WinPython resmi untuk nomor versi yang sesuai.

Mengarahkan Visual Studio ke simbol

Jika Anda mengunduh simbol secara terpisah, ikuti langkah-langkah ini untuk membuat Visual Studio mengetahui simbol.

Catatan

Jika Anda menginstal simbol dengan menggunakan penginstal Python 3.5 atau yang lebih baru, Visual Studio menemukan simbol secara otomatis. Anda tidak perlu menyelesaikan langkah-langkah di bagian ini.

  1. Pilih Opsi Alat>, dan buka tab Simbol Penelusuran Kesalahan.>

  2. Pilih Tambahkan (simbol plus) pada toolbar.

  3. Masukkan jalur folder tempat Anda mengekstrak simbol yang diunduh. Lokasi ini adalah tempat python.pdb file berada, seperti c:\python34\Symbols, seperti yang ditunjukkan pada gambar berikut.

    Cuplikan layar yang memperlihatkan opsi simbol debugger mode campuran pada dialog Penelusuran Kesalahan Opsi Alat.

  4. Pilih OK.

Selama sesi penelusuran kesalahan, Visual Studio mungkin juga meminta lokasi file sumber untuk penerjemah Python. Jika Mengunduh file sumber, seperti dari python.org/downloads/, Anda dapat mengarahkan Visual Studio ke file yang diunduh.

Opsi penembolokan simbol

Dialog Opsi Alat>, Simbol Penelusuran Kesalahan>juga berisi opsi untuk mengonfigurasi penembolokan simbol. Visual Studio menggunakan fitur penembolokan simbol untuk membuat cache simbol lokal yang diperoleh dari sumber online.

Fitur-fitur ini tidak diperlukan dengan simbol penerjemah Python karena simbol sudah ada secara lokal. Untuk informasi selengkapnya, lihat Menentukan simbol dan file sumber di debugger Visual Studio.

Mengakses unduhan untuk distribusi resmi

Tabel berikut mencantumkan informasi unduhan untuk rilis versi Python resmi.

Versi Python Unduhan
3.5 dan yang lebih baru Pasang simbol melalui alat penginstal Python.
3.4.4 32-bit - 64-bit
3.4.3 32-bit - 64-bit
3.4.2 32-bit - 64-bit
3.4.1 32-bit - 64-bit
3.4.0 32-bit - 64-bit
3.3.5 32-bit - 64-bit
3.3.4 32-bit - 64-bit
3.3.3 32-bit - 64-bit
3.3.2 32-bit - 64-bit
3.3.1 32-bit - 64-bit
3.3.0 32-bit - 64-bit
2.7.18 32-bit - 64-bit
2.7.17 32-bit - 64-bit
2.7.16 32-bit - 64-bit
2.7.15 32-bit - 64-bit
2.7.14 32-bit - 64-bit
2.7.13 32-bit - 64-bit
2.7.12 32-bit - 64-bit
2.7.11 32-bit - 64-bit
2.7.10 32-bit - 64-bit
2.7.9 32-bit - 64-bit
2.7.8 32-bit - 64-bit
2.7.7 32-bit - 64-bit
2.7.6 32-bit - 64-bit
2.7.5 32-bit - 64-bit
2.7.4 32-bit - 64-bit
2.7.3 32-bit - 64-bit
2.7.2 32-bit - 64-bit
2.7.1 32-bit - 64-bit

Menggunakan simbol Kanopi Enthought

Enthought Canopy menyediakan simbol penelusuran kesalahan untuk binernya mulai dari versi 1.2. Simbol-simbol ini secara otomatis diinstal bersama dengan distribusi.

  • Untuk menggunakan simbol, tambahkan folder yang berisi simbol secara manual ke jalur simbol, seperti yang dijelaskan di Point Visual Studio ke simbol.

    Untuk penginstalan canopy per pengguna yang khas, simbol terletak di folder berikut:

    • Versi 64-bit: %UserProfile%\AppData\Local\Enthought\Canopy\User\Scripts
    • Versi 32-bit: %UserProfile%\AppData\Local\Enthought\Canopy32\User\Scripts

Enthought Canopy 1.1 dan yang lebih lama dan Enthought Python Distribution (EPD), tidak menyediakan simbol interpreter. Rilis ini tidak kompatibel dengan penelusuran kesalahan mode campuran.

Konten terkait