Referensi: Ekstensi Kit Pengembangan Microsoft Quantum untuk Visual Studio Code

Microsoft Quantum Development Kit (QDK) menggunakan fungsionalitas standar Visual Studio Code (Visual Studio Code), bersama dengan fitur khusus bahasa saat Anda bekerja dengan file .qs atau .qasm. Panduan referensi ini menjelaskan semua perintah QDK yang dapat Anda akses di Palet Perintah Visual Studio Code, bersama dengan fitur dan tautan lainnya ke konten tambahan. Untuk panduan visual Studio Code umum, lihat dokumentasi Visual Studio Code.

Tip

Sebagian besar perintah dari ekstensi QDK dapat diakses dari menu Lihat > Palet Perintah . Saat berada dalam file .qs atau .qasm, buka Palet Perintah dan masukkan QDK: untuk melihat daftar perintah yang sudah difilter.

Commands

Sebagian besar perintah QDK terkait dengan menulis dan menjalankan program Q# dan OpenQASM, dan hanya tersedia saat file .qs atau .qasm aktif. Perintah lain berfungsi di latar belakang dan tidak dapat diakses di Palet Perintah.

Tabel berikut ini menjelaskan perintah dari ekstensi QDK yang muncul di Palet Perintah.

Tip

Anda dapat membuat pintasan keyboard kustom untuk perintah VISUAL Code menggunakan Pintasan Keyboard, atau Ctrl + K + S. Untuk informasi selengkapnya, lihat Pengikatan Kunci untuk Visual Studio Code.

Command	Action	Catatan	Tindakan pengguna alternatif
QDK: Membuat Proyek Q#	Membuat proyek Q# di folder aktif, termasuk qsharp.json file manifes dan src subfolder dengan file default main.qs .	Untuk informasi selengkapnya tentang proyek Q#, lihat Bekerja dengan proyek Q#.	Di File Explorer, klik kanan folder target dan pilih Buat proyek Q#.
QDK: Membuat buku catatan Microsoft Quantum	Membuka contoh Jupyter Notebook yang menjalankan program Q# + Python dan mengirimkan pekerjaan ke Azure Quantum.	Untuk informasi selengkapnya tentang QDK di Jupyter Notebook, lihat Menyerahkan tugas ke Azure Quantum dari Jupyter Notebook.	N/A
QDK: Menyambungkan ke ruang kerja Azure Quantum	Sambungkan ke ruang kerja Azure Quantum menggunakan akun Azure atau string koneksi Anda. Setelah Anda diautentikasi, ruang kerja Anda muncul di File Explorer di Quantum Workspaces.	Untuk informasi selengkapnya tentang koneksi Azure Quantum, lihat Menyambungkan ke ruang kerja Azure Quantum Anda.	Di File Explorer, arahkan mouse ke atas ruang kerja Quantum dan pilih ikon + .
QDK: Membuka taman bermain QDK	Membuka folder online program sampel Q# dan OpenQASM di File Explorer. Anda dapat mengedit dan menjalankan program di simulator kuantum lokal, dan juga mengatur titik henti dan menelusuri kode dengan debugger bawaan.	Untuk informasi selengkapnya, lihat file README di folder sampel.	N/A
QDK: Refresh ruang kerja Azure Quantum	Menyinkronkan perubahan terbaru dari ruang kerja kuantum yang terhubung.	Jika ada masalah koneksi, ikon pemberitahuan muncul di samping nama ruang kerja.	Di File Explorer, arahkan mouse ke atas Ruang Kerja Quantum dan pilih ikon refresh.
Penjelajah: Fokus pada Tampilan Ruang Kerja Quantum	Membuka Penjelajah Berkas dan berfokus pada ruang kerja kuantum yang terhubung, jika dikonfigurasi. Jika tidak ada ruang kerja yang dikonfigurasi, Anda akan diminta untuk menambahkan ruang kerja yang sudah ada.	Untuk informasi selengkapnya tentang koneksi Azure Quantum, lihat Menyambungkan ke ruang kerja Azure Quantum Anda.	N/A

Perintah berikut tersedia saat .qs file atau .qasm aktif.

Command	Action	Catatan	Tindakan pengguna alternatif
QDK: Tampilkan sirkuit	Menampilkan diagram sirkuit untuk program sebelum dijalankan.	Untuk informasi selengkapnya, lihat Memvisualisasikan diagram sirkuit kuantum.	Pilih opsi lensa Sirkuit dari menu di samping operasi titik masuk atau di atas setiap operasi yang didefinisikan oleh pengguna dalam program.
QDK: Jalankan file dan tampilkan histogram	Menjalankan program saat ini dan menampilkan histogram hasil di panel baru.	Untuk mengakses opsi pengurutan dan filter untuk tampilan histogram, pilih ikon filter di panel histogram.	Pilih opsi CodeLens Histogram dari menu di samping operasi titik masuk.
QDK: Dapatkan QIR untuk program QDK saat ini	Membuka sumber QIR untuk kode Q# atau OpenQASM saat ini di jendela edit baru. Program Anda harus menggunakan profil target Base, Adaptive RI, atau Adaptive RIF untuk mengekspor sumber QIR.	Untuk informasi selengkapnya tentang QIR, lihat Representasi perantara Quantum, dan blog pengembang QDK.	N/A
QDK: Menghitung Perkiraan Sumber Daya	Memanggil versi bawaan dari estimator sumber daya.	Untuk informasi selengkapnya, lihat Pengantar estimator sumber daya Microsoft Quantum.	N/A
QDK: Bantuan	Gambaran umum singkat ekstensi QDK di Visual Studio Code.	Untuk dokumentasi Microsoft Quantum lengkap, lihat dokumentasi Microsoft Quantum.	N/A
QDK: Jalankan file dan tampilkan diagram sirkuit	Menjalankan program saat ini dan menampilkan sirkuit program dengan output.	Untuk informasi selengkapnya, lihat Memvisualisasikan diagram sirkuit kuantum.	N/A
QDK: Tampilkan dokumentasi API	Membuka dokumentasi API di panel baru. Untuk mencari panel ini, tekan Ctrl + F.	Untuk informasi selengkapnya, lihat referensi API Microsoft Quantum.	N/A
QDK: Tampilkan Changelog	Membuka changelog di tab baru yang memperlihatkan pembaruan QDK untuk versi rilis saat ini dan sebelumnya.	Changelog juga tersedia di repositori GitHub QDK sumber terbuka.	N/A
Debug: Mulai Debugging	Membuka program saat ini di debugger.	Untuk informasi selengkapnya, lihat Men-debug dan menguji kode kuantum Anda.	Tekan F5, atau pilih opsi lensa kode Debug dari menu di samping operasi titik masuk, atau pilih ikon Jalankan di kanan atas dan pilih Mulai Debugging.
Debug: Jalankan	Menjalankan program saat ini di simulator kuantum default.	Untuk informasi selengkapnya, lihat Mulai menggunakan program Q#.	Tekan Ctrl + F5, atau pilih opsi lensa kode Jalankan dari menu di samping operasi titik entri, atau pilih ikon Jalankan di kanan atas, dan pilih Jalankan.

Terminal

Program T# dan OpenQASM menggunakan dua jendela terminal di Visual Studio Code:

Stasiun	Action
Konsol debug	Menampilkan hasil eksekusi atau hasil debug
Urusan	Menampilkan pemeriksaan kesalahan pra-kompilasi

Edit kode Q# dan OpenQASM

Sebagian besar fitur pengeditan kode umum di VISUAL Code juga tersedia saat Anda bekerja dengan program Q# dan OpenQASM:

• Pemeriksaan kesalahan prakompilasi
• Pergi ke definisi
• Referensi
• Tanda tangan fungsi
• Informasi parameter
• Saran penyelesaian, termasuk penyelesaian kontekstual, anggota namespace, dan penyelesaian anggota tipe.
• Linting - Dalam file Q#, Anda mengonfigurasi linting per proyek dalam file manifes. Untuk informasi selengkapnya, lihat Bekerja dengan proyek Q#.

Untuk informasi selengkapnya, lihat Intellisense dalam dokumentasi Visual Studio Code.

Tugas umum

Bekerja dengan file dan proyek Q#

Tugas	Action	Catatan
File Q# baru	Pilih File > File baru > File teks. Simpan file dengan .qs ekstensi.	Jika Anda mengatur Files: Default Language = qsharp, file baru secara otomatis default ke pemformatan Q#.
Membuat proyek Q#	Dari folder yang terbuka di File Explorer, pilih Buat Proyek Q# dari Palet Perintah, atau klik kanan folder di File Explorer dan pilih Buat proyek Q#.	Untuk informasi selengkapnya tentang proyek Q#, lihat Bekerja dengan proyek Q#.
File contoh	Dalam file atau .qs kosong.qasm, masukkan sampel, lalu pilih program sampel dari daftar opsi.	Anda juga dapat memilih Buka taman bermain QDK di Palet Perintah untuk membuka folder online program sampel Q# dan OpenQASM di File Explorer.

Menyambungkan ke Azure Quantum

Tugas	Action	Catatan	Tindakan pengguna alternatif
Menyambungkan ke ruang kerja Azure Quantum	Di File Explorer, perluas Ruang Kerja Quantum dan pilih Tambahkan ruang kerja yang sudah ada. Ikuti perintah untuk memilih langganan dan ruang kerja.	Anda dapat menyambungkan ke beberapa ruang kerja. Pilih + di samping Ruang Kerja Quantum untuk menyambungkan ruang kerja lain. Koneksi ruang kerja bertahan di antara sesi Visual Studio Code Anda.	Dari Palet Perintah, pilih QDK: Sambungkan ke ruang kerja Azure Quantum.
Menyambungkan secara terprogram dengan program Python	Klik kanan koneksi ruang kerja yang sudah ada dan pilih Salin kode Python untuk menyambungkan ke ruang kerja. Tempelkan kode yang dihasilkan ke dalam program Python Anda.	Untuk informasi selengkapnya, lihat Mengirimkan Python dengan pekerjaan Q# ke Azure Quantum.	N/A

Jalankan program

Tugas	Action	Catatan	Tindakan pengguna alternatif
Jalankan program Q# atau OpenQASM pada simulator kuantum lokal	Dalam file .qs atau .qasm , pilih ikon Jalankan di kanan atas, dan pilih Jalankan.	Untuk informasi selengkapnya tentang simulator kuantum Sparse, lihat simulator kuantum Sparse.	Tekan Ctrl + F5, atau pilih QDK: Jalankan file dan tampilkan histogram atau QDK: Jalankan file dan tampilkan diagram sirkuit di Palet Perintah, atau pilih opsi Jalankan lensa kode di atas operasi titik masuk.
Mendebug program	Dalam program Q# atau OpenQASM, pilih ikon Jalankan di kanan atas, dan pilih Mulai Penelusuran Kesalahan.	Untuk informasi selengkapnya tentang debugger Q# di Visual Studio Code, lihat Men-debug dan menguji kode kuantum Anda.	Tekan F5, atau pilih lens kode Debug dari menu di atas titik masuk operasi.
Melihat penyedia dan target di ruang kerja Anda	Di File Explorer, pilih Ruang Kerja Quantum, perluas ruang kerja, lalu perluas Penyedia untuk melihat penyedia yang tersedia di ruang kerja. Perluas penyedia satu per satu agar dapat melihat target yang tersedia.	Arahkan mouse ke atas nama target untuk melihat Status dan Waktu antreannya sebelum Anda mengirimkan pekerjaan.	N/A
Mengirimkan pekerjaan ke Azure Quantum	Dalam program Q# atau OpenQASM, pilih ruang kerja, penyedia, dan target. Untuk mengirimkan program saat ini, pilih panah di samping target.	Untuk informasi selengkapnya, lihat Mengirimkan pekerjaan Q# ke Azure Quantum.	N/A
Melihat hasil pekerjaan	Perluas ruang kerja lalu perluas Pekerjaan. Untuk membuka output pekerjaan dari Azure Storage, pilih ikon cloud di samping nama pekerjaan.	Pekerjaan dicantumkan dari yang terbaru ke terlama.	N/A