VS Code için N/M kullanım rehberi
N/M eklentisini kurun, ilk programınızı test edin, debugger ile adımlayın ve sık karşılaşılan sorunları çözün.
Eklentiyi kurun
VS Code Eklentiler görünümünde N/M Quantum Language arayın. Yayıncı QuantumSoftware, eklenti kimliği quantumsoftware.nm-quantum-language olmalı. Normal Install / Yükle düğmesini kullanın.
Masaüstü VS Code 1.96 veya üzeri gerekir. Dil sunucusu ve debugger pakete dahildir; ayrıca Node.js kurmanız gerekmez. Tarayıcı sürümü ve sanal çalışma alanları desteklenmez.
Marketplace'te aç ↗İlk programınız ve testiniz
Güvendiğiniz proje klasörünü açın. Ctrl+Shift+P (macOS: Cmd+Shift+P) ile komut paletini açıp N/M: Kuantum Örneği Oluştur komutunu çalıştırın. Dosyayı hello.nm olarak kaydedin. Aşağıdaki örnek, eklentinin oluşturduğu programdır.
hello.nm
1module hello_quantum;2fn main() {3 test "balanced qubit" {4 let q = qreg[1];5 H(q[0]);6 assert probability(|0>) > 0.45;7 assert probability(|1>) > 0.45;8 }9 return 0;10}N/M: Geçerli Dosyanın Testlerini Çalıştır komutuyla balanced qubit testini çalıştırın. H kapısı iki ölçüm sonucunun olasılığını da 0,5 yapar; iki doğrulama da geçmelidir. Testler ayrı süreçte çalışır ve iptal edilebilir.
Adım adım hata ayıklama
Bu devreyi debug.nm olarak kaydedin ve H satırına durak noktası koyun. Run and Debug görünümünde N/M yapılandırmasını seçin veya aşağıdaki .vscode/launch.json dosyasını oluşturup debug.nm açıkken F5'e basın.
debug.nm
1module debug_bell;2fn main() {3 let q = qreg[2];4 H(q[0]);5 CNOT(q[0], q[1]);6 return q;7}.vscode/launch.json
1{2 "version": "0.2.0",3 "configurations": [4 {5 "type": "nm",6 "request": "launch",7 "name": "N/M",8 "program": "${file}",9 "stopOnEntry": true10 }11 ]12}F11 çağrının içine girer, F10 üzerinden geçer, Shift+F11 çağrıdan çıkar. Değişkenler ve çağrı yığını kayıtlı değerleri gösterir. Restart aynı kaydı başa alır; programı veya ayarları değiştirince durdurup yeni bir kayıt başlatın.
Debugger yerel simülatör çalışmasını bir kez kaydeder. Adımlama yeniden ölçüm yapmaz ve fiziksel kuantum donanımına bağlanmaz.
Dil özellikleri ve ayarlar
Yeni kurulumlarda aşağıdaki altı özellik açıktır. Daha önce kaydettiğiniz kapalı seçimler korunur. Diğer nm.experimental.* ayarları varsayılan olarak kapalıdır. Ayarları VS Code Settings içinde N/M aratarak değiştirebilirsiniz.
nm.experimental.classicalFunctionsnm.experimental.typedClassicalValuesnm.experimental.functionResultsnm.experimental.moduleVisibilitynm.experimental.parameterGroupsnm.experimental.computeApply
Özelliklerin olgunluğu ve sınırları için N/M: Yetenek Durumunu Göster komutunu kullanın. Normal kurulum kanalı, bütün özelliklerin kararlı olduğu anlamına gelmez.
Bir sorunla karşılaşırsanız
Sunucu başlamıyor
N/M: Dil Sunucusunu Yeniden Başlat komutunu çalıştırın ve Output → N/M Language çıktısını okuyun. nm.languageServer.path için özel bir değer girdiyseniz geçerli, mutlak bir dosya yolu olmalıdır; gömülü sunucuya dönmek için özel değeri kaldırın.
Test veya debugger çalışmıyor
Dosyayı .nm uzantısıyla kaydedin, N/M dilinin seçili olduğunu ve proje klasörüne güven verdiğinizi kontrol edin. Eklenti Restricted Mode içinde kod çalıştırmaz.
Bir dil özelliği reddediliyor
N/M ayarlarında ilgili özelliği kontrol edin. Kayıtlı false seçimleri güncellemeyle açılmaz. Kaynakta bildirilen hata kodunu tanılama rehberinde arayın.
Yayın sürümü bulunamıyor
Güncel normal sürümü seçin. Ön yayın kurulmuşsa Switch to Release Version / Yayın Sürümüne Geç seçeneğini kullanın.
İletişim formunda VS Code ve eklenti sürümünü, işletim sistemini, hata kodunu ve sorunu tekrar oluşturan küçük bir örneği paylaşın. API anahtarı veya özel proje dosyaları göndermeyin.
Sorun bildirin →Ücretsiz kullanım
Kişisel, eğitim ve ticari kullanım ücretsizdir. QuantumSoftware kod ve varlık haklarını saklı tutar; kaynak kodu değiştirme veya yeniden dağıtma izni ayrıca gerekir. Kendi N/M programlarınız ve sonuçlarınız size aittir.
Dağıtım lisansını okuyun ↗