Ana içeriğe geç
Dil v0.2.0 · Ön izleme

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.

Doğrulanan normal sürümler: Marketplace 0.6.0 · Open VSX 0.6.0.

0.6.0'ı Open VSX'ten VSIX olarak indirip VS Code'da Extensions: Install from VSIX… komutuyla kurabilirsiniz. Eklenti kimliğini kontrol edin; normal kurulum için ön yayın kanalına geçmeniz gerekmez.

İ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

module hello_quantum;fn main() {  test "balanced qubit" {    let q = qreg[1];    H(q[0]);    assert probability(|0>) > 0.45;    assert probability(|1>) > 0.45;  }  return 0;}

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.

Seçili test desteği eklenti 0.3.0 ve üzerini gerektirir. Test Explorer içinde Çalıştır/Hata Ayıkla profili veya test üzerindeki CodeLens ile üst düzey kontrolleri seçin. Seçilmeyen kardeş testler yürütülmez; ortak kurulum ve özgün kaynak satırları korunur. Hata ayıklama aynı çalıştırmanın test raporunu ve kaydını kullanır. Eski kimlikler ve iç içe kontrollerin doğrudan seçimi hata verir.

0.6.0 ile gelen araçlar

0.6.0 ile gelen sayısal işlemler, çalışma alanında otomatik içe aktarma ve hazır proje şablonları güncel CLI 0.7.1 ve Core 0.7.0 ile kullanılabilir. N/M dil sözleşmesi 0.2.0 ve özelliklerin ön izleme/deneysel durumları korunur.

Bir dosya yerine tam proje oluşturun

Bell, parametrik eğitim veya sayısal hesaplama şablonunu seçin. Her proje src/main.nm, ortak src/helper.nm, tests/main.test.nm, nm-workspace.json ve seçtiğiniz dilde README.md içerir.

Komut paletinde N/M: Proje Oluştur komutunu çalıştırın; şablonu, projenin oluşturulacağı üst klasörü ve proje adını seçin. Örneğin bell-project adı üst klasörün içinde bell-project alt klasörünü oluşturur. Ad 1–64 küçük harf, rakam, nokta, alt çizgi veya kısa çizgi içerebilir; harf veya rakamla başlayıp bitmelidir. README dili VS Code arayüz dilini izler.

Oluşturulan klasörü açın. Tanılar için src/main.nm dosyasını, test için tests/main.test.nm dosyasını açıp N/M: Geçerli Dosyanın Testlerini Çalıştır komutunu kullanın. README'deki terminal komutları ayrıca CLI kurulumu gerektirir; gömülü dil sunucusu terminale nm komutu eklemez.

Oluşturucu dolu klasörün üzerine yazmaz ve kodu kendiliğinden çalıştırmaz. Sayısal şablonun README komutları --experimental-classical-functions ve --experimental-typed-classical-values bayraklarını açıkça belirtir. Manifest veya şablon deneysel izin vermez; kayıtlı kapalı ayarlar korunur.

Çalışma alanından otomatik içe aktarma

Aynı çalışma alanındaki public fonksiyon, record ve enum adlarını yazmaya başladığınızda önerilerden seçin. Editör gereken use workspace.… satırını ekler. Private semboller önerilmez; takma ad, görünürlük ve döngü kontrolleri korunur. İndeks hazırlanırken açık dosyalardaki öneriler kullanılabilir.

Eklenti veya bağımsız dil sunucusu 0.6.0 gerekir. Oluşturduğunuz projenin src klasörüne aşağıdaki iki dosyayı ekleyip ikisini de editörde açın. classicalFunctions ve typedClassicalValues açık olmalıdır; bu public bildirimi için moduleVisibility de gerekir. VS Code'daki varsayılan açık profil bu izinleri sağlar; daha önce kaydedilmiş false değerleri ayrıca değiştirmeniz gerekir.

src/math.nm

module guide_math;public fn double(value: Float) -> Float {  return value * 2.0;}

src/import-demo.nm

module import_demo;use workspace.guide_math;fn main() {  let q = qreg[1];  let result: Float = double(0.5);  return result;}

main örneği, öneri kabul edildikten sonraki hâlidir. Denemek için use workspace.guide_math; satırını kaldırın ve double adını dou yapın. İmleç dou sonundayken Ctrl+Space ile workspace.guide_math kaynaklı double önerisini seçin; tamamlama hem adı düzeltir hem import satırını ekler. Aynı adlı sembollerde önerinin kaynak modülünü kontrol edin.

Bu örnekte result değişkeninin değeri 1.0'dır. Öneri yoksa klasörü çalışma alanı olarak açtığınızı, dosyaların manifestteki src kaynak kökünde olduğunu ve ilgili özelliklerin açık olduğunu kontrol edin. Otomatik içe aktarma editör işlemidir. Rehberdeki CLI örneği aynı izinleri açıkça gösterir; kayıtlı veya aktarılan kapalı özellik seçimleri kendiliğinden açılmaz.

Yeni sayısal işlemler

eigvecsh
Float/Complex Hermitsel matrisin özvektörlerini sütunlar halinde verir; sıralama eigvalsh ile aynıdır. Faz ve dejenere özuzayın baz seçimi tek değildir. Parametreye bağlı analitik özvektör türevi desteklenmez.
solve
Gerçel A*x=b çözümünün birinci analitik türevini A*dx=db-dA*x ile hesaplar. Aynı çağrıda primal ve türev sağ tarafları pivotlu ayrıştırmayı paylaşır; Complex ve ikinci türev bu kapsamda değildir.
lstsq
Kare veya uzun, tam sütun ranklı Float sistemlerde sütun pivotlu QR ile en küçük kareler çözümünü bulur. Geniş/rank eksik matrisler ve parametreye bağlı analitik türevler desteklenmez.

Mevcut 1–16 matris boyutu, 256 eleman ve ortak işlem bütçesi sınırları değişmez. Eklentinin test ve kayıtlı debugger akışı ayrı sonlu ölçüm eğitim host'unu başlatmaz; bu host CLI'de --train ile seçilir.

Matris ve türev rehberini aç →

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

module debug_bell;fn main() {  let q = qreg[2];  H(q[0]);  CNOT(q[0], q[1]);  return q;}

.vscode/launch.json

{  "version": "0.2.0",  "configurations": [    {      "type": "nm",      "request": "launch",      "name": "N/M",      "program": "${file}",      "stopOnEntry": true    }  ]}

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.classicalFunctions
  • nm.experimental.typedClassicalValues
  • nm.experimental.functionResults
  • nm.experimental.moduleVisibility
  • nm.experimental.parameterGroups
  • nm.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.

0.3.0 ve üzeri: N/M: Araç Zinciri Oturumunu Göster komutu gerçek eklenti paketini, başlatılmış sunucunun dil/Core sürümlerini ve LSP sözleşmesini ayrı gösterir. CLI/MCP kurulumları ve sağlanmayan sunucu paket metadata'sı gözlenmedi olarak belirtilir.

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.

.nm dosya simgesi görünmüyor

Mavi NM dosya simgesi için 0.4.1 veya üzeri gerekir. Eklentiyi güncelleyip Developer: Reload Window komutunu çalıştırın. Aktif dosya simgesi teması dil simgelerini gizliyorsa Preferences: File Icon Theme → Seti (Visual Studio Code) seçin. Eklenti tema ayarlarınızı kendiliğinden değiştirmez.

İ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 ↗