Opsi untuk Python di Visual Studio

Visual Studio menyediakan dukungan untuk mengonfigurasi lingkungan pengembangan interaktif (IDE) untuk pengembangan Python. Anda dapat mengatur opsi sesuai dengan preferensi Anda dan untuk memenuhi kebutuhan lingkungan pengembangan tertentu. Artikel ini menjelaskan opsi yang tersedia untuk tata letak dan perilaku umum, penelusuran kesalahan, diagnostik, dan fitur bahasa Python tingkat lanjut.

Lokasi opsi Python

Pengaturan konfigurasi Python tersedia dari toolbar Visual Studio di bawahOpsi>. Dialog Opsi mencantumkan sebagian besar pengaturan untuk Python pada tab Python :

Anda dapat mengonfigurasi preferensi untuk debugging, analisis server bahasa Pylance, lingkungan conda, lingkungan default, dan Interactive Windows.

Panel Opsi mencantumkan pengaturan Python lainnya di bawah SemuaBahasa>Pengaturan>Python. Ada opsi untuk bilah gulir, tab, dan pemformatan, bersama dengan pengaturan umum dan tingkat lanjut. Pengaturan lain tersedia di bawah>Font lingkungan dan Warna untuk grup pengaturan Editor Teks .

Nota

Dialog Opsi mungkin menyertakan tab eksperimental atau grup untuk fitur dalam pengembangan yang tidak dijelaskan dalam artikel ini. Anda dapat menemukan informasi selengkapnya dalam posting di rekayasa Python di blog Microsoft.

Opsi khusus untuk Python

Di bawahOpsi>Alat>Python, Anda dapat mengatur opsi khusus Python untuk lingkungan umum termasuk Windows Interaktif, lingkungan conda, penelusuran kesalahan, dan banyak lagi.

Opsi Python umum

Opsi berikut ini tersedia di bawahOpsi>Alat>Python>Umum:

Option	Bawaan	Description
Tampilkan Jendela Output saat membuat lingkungan virtual	Aktif	Hapus untuk mencegah jendela Output muncul.
Tampilkan Jendela Output saat menginstal atau menghapus paket	Aktif	Hapus untuk mencegah jendela Output muncul.
Tampilkan bilah pemberitahuan untuk membuat lingkungan	Aktif	Saat mengatur dan Anda membuka proyek dengan file requirements.txt atau environment.yml , Visual Studio menampilkan bilah informasi dengan saran untuk membuat lingkungan virtual atau lingkungan conda, masing-masing, alih-alih menggunakan lingkungan global default.
Tampilkan bilah pemberitahuan untuk menginstal paket	Aktif	Saat diatur dan Anda membuka proyek dengan file requirements.txt yang tidak menggunakan lingkungan global default), Visual Studio membandingkan persyaratan tersebut dengan paket yang diinstal di lingkungan saat ini. Jika ada paket yang hilang, Visual Studio menampilkan perintah untuk menginstal dependensi tersebut.
Tampilkan bilah pemberitahuan untuk mengonfigurasi kerangka kerja pengujian	Aktif	Saat diatur, jika Visual Studio mendeteksi file di proyek Python Anda yang mungkin berisi pengujian tetapi tidak ada kerangka kerja pengujian yang diaktifkan, Visual Studio meminta Anda untuk mengaktifkan pytest atau unittest.
Selalu jalankan manajer paket sebagai administrator	Nonaktif	Selalu meningkatkan pip install dan operasi manajer paket serupa untuk semua lingkungan. Saat Anda menginstal paket, Visual Studio meminta hak istimewa administrator jika lingkungan terletak di area terlindungi dari sistem file seperti c:\Program Files. Dalam perintah itu, Anda dapat memilih untuk selalu meningkatkan perintah instal hanya untuk satu lingkungan tersebut. Untuk informasi selengkapnya, lihat tab Paket.

Opsi lingkungan Conda

Opsi berikut ini tersedia di bawahOpsi>Alat>Python>Conda:

Option	Bawaan	Description
Path yang dapat dieksekusi untuk Conda	(kosong)	Menetapkan jalur yang tepat ke file conda.exe daripada bergantung pada penginstalan Miniconda bawaan yang disertakan dengan beban kerja Python. Jika jalur lain diberikan di sini, itu diutamakan daripada penginstalan default dan eksekusi conda.exe lainnya yang ditentukan dalam registri. Anda dapat mengubah pengaturan ini jika Anda menginstal versi Anaconda atau Miniconda yang lebih baru secara manual, atau ingin menggunakan distro 32-bit daripada distro 64-bit default.

Opsi penelusuran kesalahan

Opsi berikut ini tersedia di bawahOpsi>Alat>Penelusuran Kesalahan>:

Option	Bawaan	Description
Perintah sebelum berjalan saat terjadi kesalahan	Aktif	Saat opsi ini diatur, Visual Studio meminta Anda untuk mengonfirmasi bahwa Anda ingin menjalankan kode yang memiliki kesalahan. Untuk menonaktifkan peringatan, kosongkan opsi ini.
Tunggu input saat proses keluar secara tidak normal Tunggu input saat proses keluar secara normal	Aktif (untuk keduanya)	Program Python dimulai dari Visual Studio berjalan di jendela konsolnya sendiri. Secara default, jendela menunggu Anda menekan tombol sebelum menutupnya terlepas dari bagaimana program keluar. Untuk menghapus perintah tersebut dan menutup jendela secara otomatis, hapus salah satu atau kedua opsi ini.
Arahkan output program ke jendela Debug Output	Aktif	Menampilkan output program di jendela konsol terpisah dan jendela Output Visual Studio. Kosongkan opsi ini untuk menampilkan output hanya di jendela konsol terpisah.
Memutus pada pengecualian SystemExit dengan kode keluar nol	Nonaktif	Jika diaktifkan, debugger akan berhenti pada pengecualian ini. Ketika kondisi sudah terpenuhi, debugger keluar tanpa berhenti.
Aktifkan debugging pustaka standar Python	Nonaktif	Memungkinkan untuk mengakses kode sumber pustaka standar saat debugging, tetapi meningkatkan waktu mulai debugger.
Perlihatkan nilai pengembalian fungsi	Aktif	Menampilkan nilai pengembalian fungsi di jendela Lokal lalu melangkahi panggilan fungsi di debugger (F10)
Perlihatkan variabel	Aktif	Menampilkan empat grup variabel untuk ditampilkan dan cara memformat tampilan (Grup, Sembunyikan, Sebaris). - Kelas: Default-nya adalah "Grup" - Dilindungi: Defaultnya adalah "Sebaris" - Fungsi: Standarnya adalah "Grup" - Khusus: Bawaannya adalah "Grup"

Pilihan analisis

Opsi berikut ini tersedia di bawahOpsi>Alat>Analisis>:

Option	Bawaan	Description
Mode diagnostik	Buka file saja	Menentukan file kode apa yang dianalisis server bahasa untuk masalah, termasuk Ruang Kerja dan Buka file saja.
Level log	Informasi	Menentukan tingkat pengelogan yang akan dilakukan oleh server bahasa. Tingkat pengelogan yang mungkin, dalam meningkatkan tingkat informasi yang disediakan, termasuk Kesalahan, Peringatan, Informasi, dan Jejak.
Pengecekan tipe	Nonaktif	Menentukan tingkat analisis pemeriksaan jenis yang akan dilakukan: - Nonaktif: Menghasilkan diagnostik impor/variabel yang tidak terselesaikan tetapi tidak melakukan analisis pemeriksaan jenis - Dasar: Gunakan non-tipe (semua aturan pada tingkat Nonaktif atau di bawahnya) dan juga aturan terkait pemeriksaan tipe dasar - Ketat: Gunakan semua aturan pemeriksaan jenis pada tingkat keparahan kesalahan tertinggi, termasuk semua aturan di bawah tingkat Nonaktif dan Dasar
Format Impor	Absolut	Menentukan format default saat mengimpor modul secara otomatis, termasuk Absolut atau Relatif.
Jalur pengganti	<Kosong>	Menentukan jalur ke direktori yang berisi stub tipe kustom. File stub tipe untuk setiap paket diharapkan berada di subdirektori mereka sendiri.
Jalur pencarian	<Kosong>	Menentukan jalur pencarian untuk resolusi impor. Menerima jalur yang ditentukan sebagai string dan dipisahkan oleh koma jika ada beberapa jalur, seperti ["path 1","path 2"].
Jalur yang dititik	<Kosong>	Menentukan jalur untuk Visual Studio untuk menggunakan file Typeshed kustom alih-alih versi yang dibundel.
Menambahkan jalur pencarian umum secara otomatis seperti 'src'	Aktif	Menunjukkan apakah akan menambahkan jalur pencarian secara otomatis berdasarkan nama yang telah ditentukan sebelumnya, seperti src.
Mengindeks pustaka pihak ketiga yang diinstal dan file pengguna untuk fitur bahasa seperti impor otomatis, menambahkan impor, simbol ruang kerja, dan lain-lain.	Nonaktif	Menentukan apakah server bahasa harus mengindeks file pengguna dan menginstal pustaka pihak ketiga saat startup. Indeks menyediakan serangkaian simbol yang lebih lengkap dalam fitur, termasuk impor otomatis, Perbaikan Cepat, penyelesaian otomatis, dan sebagainya. - Saat diatur, Visual Studio mengindeks simbol tingkat atas paket yang diinstal, seperti simbol di semua di bawah paket/__init__.py, bersama dengan semua simbol dari hingga 2.000 file pengguna. - Saat tidak diatur, Visual Studio menampilkan simbol yang direferensikan atau digunakan dalam file yang sebelumnya dibuka atau dimuat oleh editor.

Opsi Windows interaktif

Opsi berikut ini tersedia di bawahOpsi>Alat>Python>Interactive Windows:

Option	Bawaan	Description
Skrip	n/a	Menentukan folder umum untuk skrip startup yang akan diterapkan ke Windows Interaktif untuk semua lingkungan. Untuk informasi selengkapnya, lihat Skrip mulai. Catatan: Fitur ini mungkin tidak berfungsi di versi Visual Studio Anda.
Panah atas/bawah menavigasi riwayat	Aktif	Menggunakan tombol panah untuk menavigasi riwayat di jendela Interaktif . Kosongkan pengaturan ini untuk menggunakan tombol panah untuk menavigasi dalam output jendela Interaktif sebagai gantinya.
Mode penyelesaian	Hanya mengevaluasi ekspresi tanpa panggilan fungsi	Proses penentuan anggota yang tersedia pada ekspresi di jendela Interaktif mungkin memerlukan evaluasi ekspresi yang belum selesai saat ini, yang dapat mengakibatkan efek samping atau fungsi dipanggil beberapa kali. Pengaturan default, Hanya mengevaluasi ekspresi tanpa panggilan fungsi mengecualikan ekspresi yang muncul untuk memanggil fungsi, tetapi mengevaluasi ekspresi lain. Misalnya, mengevaluasi pernyataan a.b tetapi bukan pernyataan a().b. Jangan mengevaluasi ekspresi untuk menghindari semua efek samping, menggunakan mesin IntelliSense normal untuk saran. Mengevaluasi semua ekspresi mengevaluasi ekspresi lengkap untuk mendapatkan saran, terlepas dari efek sampingnya.
Sembunyikan saran analisis statis	Nonaktif	Saat diatur, hanya menampilkan saran yang diperoleh dengan mengevaluasi ekspresi. Jika dikombinasikan dengan nilai Mode penyelesaianJangan pernah mengevaluasi ekspresi, tidak ada penyelesaian yang berguna yang muncul di jendela Interaktif .

Opsi bahasa untuk Python

Di bagian SemuaBahasa>Pengaturan>Python, ada opsi untuk bilah gulir, tab, dan pemformatan, bersama dengan pengaturan umum dan tingkat lanjut:

Opsi editor Python umum

Opsi bahasa Python berikut ini tersedia di bagian Umum .

Nota

Banyak opsi berikut dapat diatur di tingkat global untuk semua bahasa. Pengaturan global berada di bagian Semua Pengaturan>Bahasa>Default>Umum.

Option	Bawaan	Description
Aktifkan ruang virtual	Nonaktif	Saat diatur, menyisipkan spasi di akhir setiap baris kode. Pilih opsi ini untuk memposisikan komentar pada titik yang konsisten di samping kode Anda. Mode Ruang Virtual diaktifkan dalam mode Pemilihan Kolom . Saat mode Ruang Virtual tidak diaktifkan, titik penyisipan berpindah dari akhir satu baris langsung ke karakter pertama baris berikutnya.
Pembungkus kata	Nonaktif	Atur opsi ini untuk mengizinkan baris kode panjang dibungkus berdasarkan lebar viewport editor.
Perlihatkan glyph visual untuk pembungkus kata	Nonaktif	Saat opsi bungkus Word diaktifkan, atur opsi ini untuk memperlihatkan glyph visual.
Nomor baris	Aktif	Atur opsi ini untuk menampilkan nomor baris di margin kiri editor untuk setiap baris kode.
Mengaktifkan navigasi URL klik tunggal	Aktif	Saat diatur, Anda dapat mengklik satu URL untuk menelusuri ke lokasi target.
Tampilkan info cepat di hover	Aktif	Saat diatur, Visual Studio menampilkan informasi cepat tentang kata kunci kode saat kursor diposisikan di atas elemen kode.
Penyelesaian tanda kurung otomatis	Aktif	Ketika diaktifkan, Visual Studio secara otomatis menambahkan kurung kurawal penutup untuk setiap kurung kurawal terbuka saat Anda memasukkan kode.
Terapkan Potong atau Salin ke baris kosong ketika tidak ada pilihan	Aktif	Secara default, Visual Studio memotong atau menyalin seluruh baris kode saat tidak ada pilihan eksplisit. Gunakan opsi ini untuk mengaktifkan atau menonaktifkan perilaku Potong atau Salin ini saat dipanggil pada baris kosong.

Untuk informasi selengkapnya, lihat Opsi: Editor > Teks Umum.

Opsi editor Python Tingkat Lanjut

Opsi berikut ini tersedia di bawahOpsi>Alat>Editor> TeksPython>Tingkat Lanjut:

Option	Bawaan	Description
Menawarkan penyelesaian impor otomatis	Aktif	Saat diatur, Visual Studio menawarkan impor otomatis dalam penyelesaian.
Secara otomatis menambahkan tanda kurung untuk fungsi	Nonaktif	Saat diatur, Visual Studio secara otomatis menambahkan tanda kurung untuk fungsi saat Anda memasukkan kode di editor.

Opsi Font dan Warna

Opsi Python lainnya tersedia di bawahFont dan Warna> saat grup Editor Teks diatur ke Python:

Nama-nama opsi Python semuanya diawali dengan "Python" dan jelas sendiri. Font bawaan untuk semua tema warna Visual Studio adalah Consolas 10 pt, reguler (bukan tebal). Warna default bervariasi menurut tema. Biasanya, Anda mengubah font atau warna untuk mempermudah membaca teks.