Bagikan melalui

Menginstal simbol debug untuk interpreter 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 debugging yang lengkap, debugger Python modus campuran di Visual Studio memerlukan simbol debug untuk interpreter Python agar dapat mengurai banyak struktur data internal. Simbol debug 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 ini mencakup dua tautan, salah satunya membuka artikel dokumentasi ini.

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

Dialog Buka pengaturan simbol membuka panelOpsi> ke bagian Semua Pengaturan>Simbol>.

Dialog Buka pengaturan simbol membuka dialogOpsi> ke bagianSimbol>.

Prasyarat

Periksa versi interpreter Anda

Simbol-simbol berbeda antara versi minor Python serta 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 simpulLingkungan 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 command prompt terbuka ke lokasi penginstalan lingkungan aktif.

  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.

Unduh 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 debug dan Unduh file 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.

Arahkan Visual Studio ke simbol

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

Nota

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. Buka panelOpsi> dan perluas bagian Semua Pengaturan>Debugging>Simbol>Lokasi Pencarian.

  2. Pada toolbar untuk daftar lokasi File simbol (.pdb), pilih + Tambahkan.

  3. Dalam dialog Tambahkan item , masukkan jalur folder tempat Anda mengekstrak simbol yang diunduh, lalu pilih Simpan.

    Tentukan lokasi tempat file python.pdb berada, seperti c:\python34\Symbols, seperti yang ditunjukkan pada gambar berikut.

    Cuplikan layar yang memperlihatkan cara menentukan lokasi simbol debugger mode campuran Python.

  1. Buka dialogOpsi> dan perluas bagianSimbol>.

  2. Pada toolbar untuk daftar lokasi pencarian file simbol (.pdb), pilih Tambah (simbol plus).

  3. Dalam daftar, masukkan jalur folder tempat Anda mengekstrak simbol yang diunduh, lalu pilih OK.

    Tentukan lokasi tempat file python.pdb berada, seperti c:\python34\Symbols, seperti yang ditunjukkan pada gambar berikut.

    Cuplikan layar yang memperlihatkan opsi simbol debugger mode gabungan pada menu Opsi Alat Penelusuran Kesalahan.

Selama sesi debug, Visual Studio mungkin juga meminta Anda untuk menentukan lokasi file sumber untuk penerjemah Python. Jika Anda mengunduh berkas sumber, seperti dari python.org/downloads/, Anda dapat menunjuk Visual Studio ke berkas yang diunduh.

Opsi penyimpanan sementara simbol

Bagian Semua Pengaturan>Simbol> mendukung opsi lain untuk mengonfigurasi penembolokan simbol di Subbagian Lokasi Pencariandan Pencarian dan Muat. Visual Studio menggunakan fitur caching simbol untuk membuat cache simbol lokal yang diperoleh dari sumber online.

Bagian Simbol Debugging mendukung opsi lain untuk mengonfigurasi penyimpanan sementara simbol. Visual Studio menggunakan fitur penyimpanan sementara 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.

Akses unduhan untuk mendapatkan rilisan resmi

Tabel berikut mencantumkan informasi unduhan untuk rilis versi Python resmi.

Versi Python Downloads
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

Gunakan simbol Enthought Canopy

Enthought Canopy menyediakan simbol debug untuk biner perangkat lunaknya 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 dalam Mengarahkan Visual Studio ke simbol.

    Untuk penginstalan per pengguna yang biasa dari Canopy, 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 debugging modus campuran.

Konten terkait

  • Last updated on