Referans: Visual Studio Code için Microsoft Quantum Geliştirme Seti uzantısı

Microsoft Quantum Development Kit (QDK), .qs veya .qasm dosyalarıyla çalışırken dile özgü özelliklerle birlikte Visual Studio Code (VS Code) standart işlevselliğini kullanır. Bu başvuru kılavuzunda VS Code Komut Paleti'nde erişebileceğiniz tüm QDK komutlarının yanı sıra diğer özellikler ve ek içeriğe bağlantılar açıklanmaktadır. Genel VS Code kılavuzu için VS Code belgelerine bakın.

Tip

QDK uzantısındaki komutların çoğuna Görünüm > Komut Paleti menüsünden erişilebilir. Veya .qs.qasm dosyasındayken Komut Paleti'ni açın ve filtrelenmiş komut listesini görüntülemek için QDK: girin.

Komutlar

QDK komutlarının çoğu Q# ve OpenQASM programlarının yazıp çalıştırılmasıyla ilgilidir ve yalnızca bir .qs veya .qasm dosyası etkin olduğunda kullanılabilir. Diğer komutlar arka planda çalışır ve Komut Paleti'nde erişilebilir değildir.

Aşağıdaki tabloda, Komut Paleti'nde görünen QDK uzantısından gelen komutlar açıklanmaktadır.

Tip

Klavye Kısayolları veya Ctrl + K + S tuşlarını kullanarak VS Code komutları için özel klavye kısayolları oluşturabilirsiniz. Daha fazla bilgi için bkz. VS Code için Anahtar Bağlamaları.

Command Action Notlar Alternatif kullanıcı eylemi
QDK: Q# Projesi Oluşturma Etkin klasörde bildirim dosyası ve varsayılan qsharp.json dosya içeren bir src alt klasör de dahil olmak üzere bir main.qs Q# projesi oluşturur. Q# projeleri hakkında daha fazla bilgi için bkz . Q# projeleriyle çalışma. Dosya Gezgini'da hedef klasöre sağ tıklayın ve Q# projesi oluştur'u seçin.
QDK: Microsoft Quantum not defteri oluşturma Q# + Python programı çalıştıran ve Azure Quantum'a iş gönderen örnek bir Jupyter Not Defteri açar. Jupyter Notebook'tan Azure Quantum'a iş göndermek hakkında daha fazla bilgi için bkz. Jupyter Notebook'tan Azure Quantum'a İşler Gönderme. N/A
QDK: Azure Quantum çalışma alanına bağlanma Azure hesabınızı veya bağlantı dizesi kullanarak bir Azure Quantum çalışma alanına bağlanın. Kimliğiniz doğrulandıktan sonra, çalışma alanınız Quantum Çalışma Alanları altındaki Dosya Gezgini'nde görünür. Azure Quantum bağlantıları hakkında daha fazla bilgi için bkz . Azure Quantum çalışma alanınıza bağlanma. Dosya Gezgini'nde Quantum çalışma alanlarının üzerine gelin ve + simgesini seçin.
QDK: QDK oyun alanı açın Dosya Gezgini'nde Q# ve OpenQASM örnek programlarının çevrimiçi bir klasörünü açar. Programları yerel kuantum simülatöründe düzenleyebilir ve çalıştırabilir, ayrıca kesme noktaları ayarlayabilir ve yerleşik hata ayıklayıcı ile kodda adım adım ilerleyebilirsiniz. Daha fazla bilgi için örnek klasördeki BENİOKU dosyasına bakın. N/A
QDK: Azure Quantum çalışma alanlarını yenileme Bağlı kuantum çalışma alanlarınızdaki en son değişiklikleri eşitler. Bağlantı sorunu varsa, çalışma alanı adının yanında bir uyarı simgesi görüntülenir. Dosya Gezgini'nde Quantum Çalışma Alanları'nın üzerine gelin ve yenileme simgesini seçin.
Gezgin: Kuantum Çalışma Alanları Görünümüne Odaklan Dosya Gezgini açar ve yapılandırılmışsa bağlı kuantum çalışma alanlarınıza odaklanır. Hiçbir çalışma alanı yapılandırılmamışsa, var olan bir çalışma alanını eklemeniz istenir. Azure Quantum bağlantıları hakkında daha fazla bilgi için bkz . Azure Quantum çalışma alanınıza bağlanma. N/A

.qs veya .qasm dosyası etkin olduğunda aşağıdaki komutlar kullanılabilir.

Command Action Notlar Alternatif kullanıcı eylemi
QDK: Devreyi göster Program çalışmadan önce program için bir devre diyagramı görüntüler. Daha fazla bilgi için bkz . Kuantum devresi diyagramlarını görselleştirme. Giriş noktası işleminin yanındaki menüden veya programdaki kullanıcı tanımlı her işlemin üstünden Devre kod merceği seçeneğini belirleyin.
QDK: Dosyayı çalıştırma ve histogramı gösterme Geçerli programı çalıştırır ve sonuçların histogramını yeni bir bölmede görüntüler. Histogram görünümünün sıralama ve filtre seçeneklerine erişmek için histogram bölmesindeki filtre simgesini seçin. Giriş noktası işleminin yanındaki menüden Histogram kod merceği seçeneğini belirleyin.
QDK: Geçerli QDK programı için QIR alma Geçerli Q# veya OpenQASM kodu için QIR kaynağını yeni bir düzenleme penceresinde açar. Programınızın QIR kaynağını dışarı aktarmak için Temel, Uyarlamalı RI veya Uyarlamalı RIF hedef profilini kullanması gerekir. QIR hakkında daha fazla bilgi için bkz. Kuantum ara gösterimi ve QDK geliştirici blogu. N/A
QDK: Kaynak Tahminlerini Hesaplama Kaynak tahmin aracının yerleşik sürümünü çağırır. Daha fazla bilgi için bkz. Microsoft Quantum kaynak tahmin aracına giriş. N/A
QDK: Yardım VS Code'daki QDK uzantısına kısa bir genel bakış. Microsoft Quantum belgelerinin tamamı için bkz. Microsoft Quantum belgeleri. N/A
QDK: Dosya çalıştırma ve devre diyagramını gösterme Geçerli programı çalıştırır ve çıkışlarla programın bir devresini görüntüler. Daha fazla bilgi için bkz . Kuantum devresi diyagramlarını görselleştirme. N/A
QDK: API belgelerini gösterme API belgelerini yeni bir bölmede açar. Bu bölmede arama yapmak için Ctrl + F tuşlarına basın. Daha fazla bilgi için bkz. Microsoft Quantum API başvurusu. N/A
QDK: Değişiklik günlüğü göster Geçerli ve önceki tüm sürüm sürümleri için QDK güncelleştirmelerini gösteren yeni bir sekmede değişiklik günlüğü açar. Değişiklik günlüğü açık kaynak QDK GitHub deposunda da kullanılabilir. N/A
Hata Ayıklama: Hata Ayıklamayı Başlat Geçerli programı hata ayıklayıcıda açar. Daha fazla bilgi için bkz . Kuantum kodunuzda hata ayıklama ve test etme. F5 tuşuna basın veya giriş noktası işleminin yanındaki menüden Hata ayıkla kod merceği seçeneğini belirleyin veya sağ üstteki Çalıştır simgesini seçip Hata Ayıklamayı Başlat'ı seçin.
Hata ayıklama: Çalıştır Geçerli programı varsayılan kuantum simülatöründe çalıştırır. Daha fazla bilgi için bkz . Q# programlarını kullanmaya başlama. Ctrl + F5 tuşlarına basın veya giriş noktası işleminin yanındaki menüden Çalıştır kod merceği seçeneğini belirleyin ya da sağ üstteki Çalıştır simgesini seçin ve Çalıştır'ı seçin.

Terminaller

Q# ve OpenQASM programları VS Code'da iki terminal penceresi kullanır:

Terminal Action
Hata ayıklama konsolu Çalıştırma çıktısını veya hata ayıklama çıktılarını görüntüler
Sorun Derleme öncesi hata denetimlerini görüntüler

Q# ve OpenQASM kodunu düzenleme

VS Code'daki yaygın kod düzenleme özelliklerinin çoğu Q# ve OpenQASM programlarıyla çalışırken de kullanılabilir:

  • Derleme öncesi hata denetimi
  • Tanımına git
  • Referanslar
  • İşlev imzaları
  • Parametre bilgileri
  • Bağlam bilgisi olan, ad alanı üyesi ve tür üyesi tamamlamaları da dahil olmak üzere tamamlama önerileri.
  • Linting - Q# dosyalarında bildirim dosyasında proje başına linting yapılandırırsınız. Daha fazla bilgi için Q# projeleriyle çalışma bölümüne bkz.

Daha fazla bilgi için VS Code belgelerindeki IntelliSense'e bakın.

Genel görevler

Q# dosyaları ve projeleriyle çalışma

Görev Action Notlar
Yeni Q# dosyası Dosya > Yeni Dosya > Metin Dosyası öğesini seçin. Dosyayı .qs uzantısıyla kaydedin. ayarlarsanız Files: Default Language = qsharp, yeni bir dosya otomatik olarak Q# biçimlendirmesi olarak ayarlanır.
Q# projesi oluşturma Dosya Gezgini'daki açık bir klasörden Komut Paleti'nden Q# Projesi Oluştur'u seçin veya Dosya Gezgini'da klasöre sağ tıklayıp Q# projesi oluştur'u seçin. Q# projeleri hakkında daha fazla bilgi için bkz . Q# projeleriyle çalışma.
Örnek dosyalar Boş .qs veya .qasm dosyaya örnekler girin ve seçenekler listesinden bir örnek program seçin. Ayrıca Komut Paleti'nde QDK oyun alanını aç'ı seçerek Dosya Gezgini'nde Q# ve OpenQASM örnek programlarının çevrimiçi bir klasörünü açabilirsiniz.

Azure Quantum'a bağlanma

Görev Action Notlar Alternatif kullanıcı eylemi
Azure Quantum çalışma alanına bağlanma Dosya Gezgini'nde Quantum Çalışma Alanları'yı genişletin ve Var olan bir çalışma alanı ekle'yi seçin. Abonelik ve çalışma alanı seçmek için istemleri izleyin. Birden çok çalışma alanına bağlanabilirsiniz. Başka bir çalışma alanına bağlanmak için Kuantum Çalışma Alanları'nın yanındaki + simgesini seçin. Çalışma alanı bağlantıları VS Code oturumlarınız arasında kalır. Komut Paleti'nden QDK: Azure Quantum çalışma alanına bağlanma'yı seçin.
Python programı ile programatik olarak bağlanma Var olan bir çalışma alanı bağlantısına sağ tıklayın ve Çalışma alanına bağlanmak için Python kodunu kopyala'yı seçin. Sonuçta elde edilen kodu Python programınıza yapıştırın. Daha fazla bilgi için bkz . Q# işleri ile Python'ı Azure Quantum'a gönderme. N/A

Programları çalıştırma

Görev Action Notlar Alternatif kullanıcı eylemi
Yerel kuantum simülatöründe Q# veya OpenQASM programı çalıştırma .qs veya .qasm dosyasında, sağ üst köşedeki Çalıştır simgesini seçin ve Çalıştır'ı seçin. Kuantum simülatörü hakkında daha fazla bilgi için bkz . Seyrek kuantum simülatörü. Ctrl + F5 tuşlarına basın veya Komut Paleti'nde QDK: Dosyayı çalıştır ve histogramı göster ya da QDK: Dosyayı çalıştır ve devre diyagramını göster seçeneklerinden birini seçin veya giriş noktası işleminin üzerindeki Çalıştır kod lensi seçeneğini belirleyin.
Programda hata ayıklama Q# veya OpenQASM programında sağ üstteki Çalıştır simgesini seçin ve ardından Hata Ayıklamayı Başlat'ı seçin. VS Code'daki Q# hata ayıklayıcısı hakkında daha fazla bilgi için bkz . Kuantum kodunuzda hata ayıklama ve test etme. F5 tuşuna basın veya giriş noktası işleminin üzerindeki menüden Hata ayıklama kod merceci kodunu seçin.
Çalışma alanlarınızdaki sağlayıcıları ve hedefleri görüntüleme Dosya Gezgini'nde Kuantum Çalışma Alanları'nı seçin, çalışma alanını genişletin ve ardından Sağlayıcılar'ı genişleterek çalışma alanında kullanılabilir sağlayıcıları görün. Kullanılabilir hedefleri görüntülemek için tek bir sağlayıcıyı genişletin. Bir iş göndermeden önce Durum ve Kuyruk süresini görüntülemek için bir hedef adının üzerine gelin. N/A
Azure Quantum'a iş gönderme Q# veya OpenQASM programında bir çalışma alanı, sağlayıcı ve hedef seçin. Geçerli programı göndermek için hedefin yanındaki oku seçin. Daha fazla bilgi için bkz . Q# işlerini Azure Quantum'a gönderme. N/A
İş sonuçlarını görüntüleme Çalışma alanını genişletin ve ardından İşler'i genişletin. Azure Depolama'dan iş çıktısını açmak için iş adının yanındaki bulut simgesini seçin. İşler en yenisinden en eskisine listelenir. N/A
  • Last updated on