Bagikan melalui


Mulai cepat: Membuka dan menjalankan kode Python dalam folder di Visual Studio

Dalam mulai cepat ini, Anda mengikuti langkah-langkah terpandu untuk menjalankan kode Python di Visual Studio 2019 dan yang lebih baru tanpa harus membuat proyek Visual Studio. Visual Studio memudahkan untuk membuka dan menjalankan kode Python yang ada dari folder. Fitur dan perintah yang sama tersedia untuk pengembangan kode Python Anda seperti saat Anda memilih untuk bekerja dengan proyek.

Prasyarat

  • Visual Studio diinstal dengan dukungan untuk beban kerja Python. Untuk informasi selengkapnya, lihat Menginstal dukungan Python di Visual Studio.

  • Instruksi dalam mulai cepat ini berlaku untuk folder apa pun dengan kode Python. Untuk mengikuti contoh yang dijelaskan dalam artikel ini, kloning gregmalcolm/python_koans repositori GitHub ke komputer Anda dengan menggunakan perintah berikut:

    git clone https://github.com/gregmalcolm/python_koans
    

Visual Studio untuk Mac tidak didukung. Untuk informasi selengkapnya, lihat Apa yang terjadi pada Visual Studio untuk Mac? Visual Studio Code di Windows, Mac, dan Linux berfungsi dengan baik dengan Python melalui ekstensi yang tersedia.

Buka folder kode lokal

Ikuti langkah-langkah ini untuk membuka folder lokal dengan kode Python yang ada di Visual Studio:

  1. Luncurkan Visual Studio. Di jendela mulai, pilih Buka folder lokal di kolom Memulai :

    Cuplikan layar yang memperlihatkan cara memilih opsi Buka folder lokal saat Visual Studio 2022 dimulai.

    Cuplikan layar yang memperlihatkan cara memilih opsi Buka folder lokal saat Visual Studio dimulai.

    Jika Anda menggunakan python_koans kode contoh repositori, pastikan untuk memilih folder python3 dalam folder kloning.

    Jika Visual Studio sudah berjalan, Anda dapat memilih Buka>File>Folder sebagai gantinya.

  2. Telusuri ke folder yang berisi kode Python Anda dan pilih Pilih Folder:

    Cuplikan layar yang memperlihatkan cara memilih folder lokal yang memiliki kode Python yang ada di Visual Studio 2022.

    Cuplikan layar yang memperlihatkan cara memilih folder lokal yang memiliki kode Python yang ada di Visual Studio.

  3. Visual Studio menampilkan file dalam Penjelajah Solusi di Tampilan Folder. Anda dapat memperluas dan menciutkan folder dengan menggunakan panah di sebelah kiri nama folder:

    Cuplikan layar yang memperlihatkan panah perluas dan ciutkan untuk folder di Penjelajah Solusi di Visual Studio 2022.

    Cuplikan layar yang memperlihatkan panah perluas dan ciutkan untuk folder di Penjelajah Solusi di Visual Studio.

  4. Saat Anda membuka folder Python, Visual Studio membuat beberapa folder tersembunyi untuk mengelola pengaturan yang terkait dengan program. Untuk melihat folder ini (dan file dan folder tersembunyi lainnya, seperti folder .git ), pilih opsi toolbar Tampilkan Semua File :

    Cuplikan layar yang memperlihatkan cara menampilkan folder dan file tersembunyi di Penjelajah Solusi di Visual Studio 2022.

    Cuplikan layar yang memperlihatkan cara menampilkan folder dan file tersembunyi di Penjelajah Solusi di Visual Studio.

Jalankan program

Setelah membuka kode Python yang ada di Visual Studio, Anda dapat menjalankan program. Untuk menjalankan kode, Anda perlu mengidentifikasi File Startup (Item Startup) atau file program utama untuk Visual Studio untuk menjalankan program. Dalam contoh ini, file startup contemplate-koans.py.

  1. Di Penjelajah Solusi, klik kanan file contemplate-koans.py dan pilih Atur sebagai Item Startup:

    Cuplikan layar yang memperlihatkan cara mengatur file Python koans kontemplate sebagai item startup di Penjelajah Solusi di Visual Studio 2022.

    Cuplikan layar yang memperlihatkan cara mengatur file Python koans kontemplate sebagai item startup di Penjelajah Solusi di Visual Studio.

    Penting

    Jika Item Startup Anda tidak terletak di akar folder yang Anda buka, Anda juga harus menambahkan baris ke file JSON konfigurasi peluncuran seperti yang dijelaskan dalam Mengatur direktori kerja.

  2. Jalankan kode dengan memilih Debug>Mulai tanpa Penelusuran Kesalahan atau gunakan pintasan keyboard Ctrl+F5. Anda juga dapat memilih panah putar solid di samping nama Item Startup pada toolbar Visual Studio. Opsi ini menjalankan kode di Visual Studio Debugger.

    Untuk semua metode mulai ini, Visual Studio mendeteksi bahwa Item Startup Anda adalah file Python dan secara otomatis menjalankan kode di lingkungan Python default. Lingkungan saat ini ditampilkan di sebelah kanan nama Item Startup pada toolbar. Dalam contoh berikut, lingkungan saat ini adalah Python 3.11 (64-bit):

    Cuplikan layar yang memperlihatkan cara memulai program dengan penelusuran kesalahan dengan menggunakan panah putar solid pada toolbar Visual Studio 2022.

    Untuk semua metode mulai ini, Visual Studio mendeteksi bahwa Item Startup Anda adalah file Python dan secara otomatis menjalankan kode di lingkungan Python default. Lingkungan saat ini ditampilkan di sebelah kanan nama Item Startup pada toolbar. Dalam contoh berikut, lingkungan saat ini adalah Python 3.6 (32-bit):

    Cuplikan layar yang memperlihatkan cara memulai program dengan penelusuran kesalahan dengan menggunakan panah putar solid di Visual Studio.

    Jika Anda tidak melihat Lingkungan Python saat ini di toolbar, pilih Tampilkan>Lingkungan Python windows>lainnya.

  3. Saat program berjalan, Visual Studio membuka jendela perintah untuk menampilkan output program:

    Cuplikan layar jendela output yang dibuka Visual Studio 2022 untuk output program dari kode Python yang sedang berjalan.

    Cuplikan layar jendela output yang dibuka Visual Studio untuk output program dari kode Python yang sedang berjalan.

    Catatan

    Jika Anda menjalankan python-koans program dengan penelusuran kesalahan, Anda perlu mengubah nilai dalam kode agar program menyelesaikan eksekusi.

  4. Anda dapat menjalankan kode di lingkungan Python yang berbeda:

    1. Perluas daftar dropdown Python Environment saat ini di toolbar Visual Studio dan pilih lingkungan yang diinginkan.

    2. Mulai ulang program Anda.

  5. Saat Anda siap untuk menutup folder kode di Visual Studio, pilih Folder Tutup File>.

Mengatur direktori kerja

Secara default, Visual Studio menjalankan proyek Python yang dibuka sebagai folder di akar folder yang sama. Namun, kode dalam proyek Anda mungkin mengharapkan Python berjalan dalam subfolder. Saat kode Anda mengharapkan untuk menemukan file di lokasi yang berbeda dari konfigurasi default yang dikenali oleh Visual Studio, Anda dapat mengalami kesalahan saat mencoba menjalankan kode.

Misalkan Anda membuka folder python_koans akar repositori dan melihat subfolder bernama python3 yang berisi file Python bernama contemplate-koans.py. Anda memutuskan untuk mengatur file python3/contemplate-koans.py sebagai File Startup. Saat menjalankan kode, Anda akan melihat kesalahan bahwa file bernama koans.txt tidak dapat ditemukan. Kesalahan terjadi karena file contemplate-koans.py mengharapkan Python berjalan di folder python3 daripada akar repositori.

Dalam kasus seperti itu, Anda juga harus menambahkan baris ke file JSON konfigurasi peluncuran untuk menentukan direktori kerja:

  1. Di Penjelajah Solusi, klik kanan File Startup Python (.py) dan pilih Tambahkan Konfigurasi Debug:

    Cuplikan layar yang memperlihatkan cara memilih opsi Tambahkan Konfigurasi Debug untuk file yang dipilih di Penjelajah Solusi di Visual Studio 2022.

  2. Dalam dialog Pilih Debugger, pilih opsi Default dalam daftar, lalu pilih Pilih:

    Cuplikan layar yang memperlihatkan cara memilih Debugger Default dalam dialog Pilih Debugger di Visual Studio 2022.

    Catatan

    Jika Anda tidak melihat Default sebagai opsi, pastikan untuk memilih file .py Python saat Anda memilih perintah Tambahkan Konfigurasi Debug. Visual Studio menggunakan jenis file untuk menentukan opsi debugger mana yang akan ditampilkan.

  3. Visual Studio membuka file bernama launch.vs.json, yang terletak di folder .vs tersembunyi. File ini menjelaskan konteks penelusuran kesalahan untuk proyek. Untuk menentukan direktori kerja, tambahkan nilai untuk "workingDirectory" properti . python-koans Misalnya, Anda dapat menambahkan properti dan nilai, "workingDirectory": "python3":

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. Simpan perubahan Anda ke file launch.vs.json .

  5. Jalankan program Anda lagi. Eksekusi kode sekarang harus berjalan di folder yang ditentukan.

  1. Di Penjelajah Solusi, klik kanan File Startup Python (.py) dan pilih Debug dan Luncurkan Pengaturan:

    Cuplikan layar yang memperlihatkan cara memilih opsi Debug dan Luncurkan Pengaturan untuk file yang dipilih di Penjelajah Solusi di Visual Studio.

  2. Dalam dialog Pilih Debugger, pilih opsi Default dalam daftar, lalu pilih Pilih:

    Cuplikan layar yang memperlihatkan cara memilih Debugger Default dalam dialog Pilih Debugger di Visual Studio.

    Catatan

    Jika Anda tidak melihat Default sebagai opsi, pastikan untuk memilih file .py Python saat Anda memilih perintah Debug dan Luncurkan Pengaturan. Visual Studio menggunakan jenis file untuk menentukan opsi debugger mana yang akan ditampilkan.

  3. Visual Studio membuka file bernama launch.vs.json, yang terletak di folder .vs tersembunyi. File ini menjelaskan konteks penelusuran kesalahan untuk proyek. Untuk menentukan direktori kerja, tambahkan nilai untuk "workingDirectory" properti . python-koans Misalnya, Anda dapat menambahkan properti dan nilai, "workingDirectory": "python3":

    {
      "version": "0.2.1",
      "defaults": {},
      "configurations": [
        {
          "type": "python",
          "interpreter": "(default)",
          "interpreterArguments": "",
          "scriptArguments": "",
          "env": {},
          "nativeDebug": false,
          "webBrowserUrl": "",
          "project": "contemplate_koans.py",
          "projectTarget": "",
          "name": "contemplate_koans.py",
          "workingDirectory": "python3"
        }
      ]
    }
    
  4. Simpan perubahan Anda ke file launch.vs.json .

  5. Jalankan program Anda lagi. Eksekusi kode sekarang harus berjalan di folder yang ditentukan.