Referensi: Ekstensi Kit Pengembangan Azure Quantum untuk Visual Studio Code
Azure Quantum Development Kit (QDK) menggunakan semua fungsionalitas standar Visual Studio (VS) Code, bersama dengan fitur Q#-specific saat bekerja dengan file .qs. Artikel ini adalah panduan referensi untuk semua perintah dan fitur terkait Q#, dengan tautan ke konten tambahan sesuai kebutuhan. Untuk panduan visual Studio Code umum, lihat dokumentasi Visual Studio Code.
Tip
Sebagian besar perintah terkait Q# dapat diakses dari menu Tampilkan > Palet Perintah. Saat berada dalam file .qs, pilih Ctrl-Shift-P (Cmd-Shift-P di macOS) dan masukkan Q# untuk melihat daftar perintah yang difilter.
Untuk semua pintasan keyboard macOS, lihat Pintasan keyboard untuk macOS.
Perintah
Sebagian besar perintah terkait Q# dapat diakses dari menu Tampilkan > Palet Perintah. Pilih Ctrl-Shift-P dan masukkan Q# untuk melihat daftar perintah yang difilter. Beberapa perintah hanya tersedia ketika file .qs aktif.
Tip
Anda dapat membuat pintasan keyboard kustom untuk perintah VISUAL Studio Code apa pun menggunakan Pintasan Keyboard, atau Ctrl+K+S. Untuk informasi selengkapnya, lihat Pengikatan Kunci untuk Visual Studio Code.
| Perintah | Perbuatan | Catatan | Tindakan pengguna alternatif |
|---|---|---|---|
| T#: Buat Proyek Q# | Membuat proyek Q# di folder aktif, termasuk: * file manifes qsharp.json * subfolder src dengan file main.qs default. |
Untuk informasi selengkapnya tentang proyek Q#, lihat Bekerja dengan proyek Q#. | Di File Explorer, klik kanan folder target dan pilih Buat proyek Q#. |
| T#: Membuat buku catatan Azure Quantum | Membuka contoh Jupyter Notebook yang menjalankan program Q# + Python dan mengirimkan pekerjaan ke Azure Quantum. | Untuk informasi selengkapnya tentang notebook Azure Quantum, lihat Bekerja dengan notebook Azure Quantum. | T/A |
| T#: 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 "+". |
| T#: Buka taman bermain Q# | Membuka folder online program sampel Q# 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. | T/A |
| T#: 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 File Explorer 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. | T/A |
Perintah berikut tersedia saat file .qs aktif.
| Perintah | Perbuatan | Catatan | Tindakan pengguna alternatif |
|---|---|---|---|
| T#: Atur profil target QIR Azure Quantum | Mengatur representasi perantara QIR, atau kuantum, profil target untuk program Q# Anda. | Untuk informasi selengkapnya tentang profil target, lihat Profil target. | Profil target saat ini ditampilkan di toolbar bawah. Pilih profil target pada toolbar untuk membuka dropdown pilihan. |
| T#: Tampilkan sirkuit | Menampilkan diagram sirkuit untuk program Q# sebelum dijalankan. | Untuk informasi selengkapnya, lihat Memvisualisasikan diagram sirkuit kuantum. | Pilih opsi lensa kode Sirkuit dari menu di samping operasi titik masuk atau di atas setiap operasi yang ditentukan pengguna dalam program. |
| T#: Jalankan file dan perlihatkan histogram | Menjalankan program Q# saat ini dan menampilkan histogram hasil di panel kanan. | Untuk mengakses opsi pengurutan dan filter untuk tampilan histogram, pilih ikon filter di panel histogram. | Pilih opsi lensa kode Histogram dari menu di samping operasi titik masuk. |
| T#: Dapatkan QIR untuk program Q# saat ini | Membuka sumber QIR untuk kode Q# saat ini di jendela edit baru. Program Anda harus menggunakan profil target Base atau Adaptive RI untuk mengekspor sumber QIR. | Untuk informasi selengkapnya tentang QIR, lihat Representasi perantara Quantum, dan blog pengembang Q#. | T/A |
| Debug: Debug file Q# | Membuka program Q# saat ini di debugger. | Untuk informasi selengkapnya, lihat Men-debug dan menguji kode kuantum Anda. | * Pilih F5 * Pilih opsi lensa kode Debug dari menu di samping operasi titik masuk. * Pilih ikon Jalankan di kanan atas, dan pilih Debug file Q#. |
| Debug: Jalankan file Q# | Menjalankan program Q# saat ini di simulator kuantum default. | Untuk informasi selengkapnya, lihat Mulai menggunakan program Q#. | * Pilih Ctrl+F5 * Pilih opsi lensa kode Jalankan dari menu di samping operasi titik masuk. * Pilih ikon Jalankan di kanan atas, dan pilih Jalankan file Q#. |
| T#: Hitung Perkiraan Sumber Daya | Memanggil versi bawaan Dari Estimator Sumber Daya. | Untuk informasi selengkapnya, lihat Pengantar Estimator Sumber Daya Azure Quantum. | T/A |
| T#: Bantuan | Gambaran umum singkat ekstensi QDK di Visual Studio Code. | Untuk dokumentasi Azure Quantum lengkap, lihat dokumentasi Azure Quantum. | T/A |
| T#: Jalankan file dan tampilkan diagram sirkuit | Menjalankan program Q# saat ini dan menampilkan sirkuit program dengan output. | Untuk informasi selengkapnya, lihat Memvisualisasikan diagram sirkuit kuantum. | T/A |
| T#: Tampilkan dokumentasi API | Membuka dokumentasi API di panel baru. Cari panel ini menggunakan Ctrl-F. | Untuk informasi selengkapnya, lihat referensi Azure Quantum API. | T/A |
Terminal
Program T# menggunakan dua jendela terminal di Visual Studio Code:
| Terminal | Perbuatan |
|---|---|
| Konsol debug | Menampilkan output eksekusi atau output debug |
| Urusan | Menampilkan pemeriksaan kesalahan pra-kompilasi |
Mengedit kode Q#
Sebagian besar fitur pengeditan kode umum di VISUAL Code tersedia saat bekerja dengan program Q#. Untuk informasi selengkapnya, lihat Intellisense dalam dokumentasi Visual Studio Code.
- Pemeriksaan kesalahan prakombinasi
- Definisi masuk
- Referensi
- Tanda tangan fungsi
- Informasi parameter
- Saran penyelesaian
- Linting - Dalam file Q#, Anda mengonfigurasi linting per proyek dalam file manifes. Untuk informasi selengkapnya, lihat Bekerja dengan proyek Q#.
Tugas umum
Bekerja dengan file dan proyek Q#
| Tugas | Perbuatan | Catatan |
|---|---|---|
| File Q# baru | Pilih File > File > baru File teks. Simpan file dengan ekstensi .qs. | Jika Anda mengatur Files: Default Language = qsharp, file baru default ke pemformatan Q# secara otomatis. |
| 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 sampel | Dalam file .qs kosong, masukkan sampel, lalu pilih program sampel dari daftar. | Anda juga dapat memilih Buka taman bermain Q# di Palet Perintah untuk membuka folder online program sampel Q# di File Explorer. |
Menyambungkan ke Azure Quantum
| Tugas | Perbuatan | 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 terhubung 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. * Untuk menghapus koneksi ruang kerja, klik kanan ruang kerja dan pilih Hapus koneksi ruang kerja. |
Dari Palet Perintah, pilih 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. | T/A |
Menjalankan program
| Tugas | Perbuatan | Catatan | Tindakan pengguna alternatif |
|---|---|---|---|
| Jalankan program Q# pada simulator kuantum lokal | Dalam program Q#, pilih ikon Jalankan di kanan atas, dan pilih Jalankan file Q#. | Untuk informasi selengkapnya tentang simulator kuantum, lihat simulator kuantum Sparse. | * Pilih Ctrl-F5 * Dari Palet Perintah, pilih Q#: Jalankan file dan tampilkan histogram atau Q#: Jalankan file dan tampilkan diagram sirkuit * Pilih opsi lensa kode Jalankan dari menu di samping operasi titik masuk. |
| Men-debug program | Dalam program Q#, pilih ikon Jalankan di kanan atas, dan pilih Debug file Q# . | Untuk informasi selengkapnya tentang debugger Q# di Visual Studio Code, lihat Men-debug dan menguji kode kuantum Anda. | * Pilih F5 * Pilih opsi lensa kode Debug dari menu di samping operasi titik masuk. |
| 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 individual untuk melihat target yang tersedia. | Catatan: Arahkan mouse ke atas nama target untuk melihat Status dan Waktu antreannya sebelum mengirimkan pekerjaan. | T/A |
| Mengirimkan pekerjaan ke Azure Quantum | Dalam program Q#, pilih ruang kerja, penyedia, dan target. Untuk mengirimkan program Q# saat ini, pilih panah di samping target. | Untuk informasi selengkapnya, lihat Mengirimkan pekerjaan Q# ke Azure Quantum. | T/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 tercantum dengan yang terbaru di atas. | T/A |