Cursor'a Başlangıç: Tab Tamamlama, Satır İçi Düzenleme ve Agent

Cursor nedir?

Cursor, VS Code tabanlı ve yapay zekâ özellikleri editörün içine yerleştirilmiş bir kod editörüdür. VS Code kullandıysanız arayüz, eklentiler ve kısayollar size tanıdık gelir; ilk açılışta VS Code ayarlarınızı ve eklentilerinizi içe aktarabilirsiniz. Bu derste Cursor'un günlük işte en çok kullanılan üç özelliğini öğreneceğiz: Tab tamamlama, satır içi düzenleme ve Agent.

1. Tab: akıllı tamamlama

Siz yazarken Cursor sonraki satırları, hatta birden çok yeri kapsayan düzenlemeleri gri metin olarak önerir. Öneriyi Tab ile kabul eder, Esc ile reddedersiniz. Örneğin bir fonksiyonun adını ve ilk satırını yazdığınızda gövdesini önerebilir:

// Fiyat listesinden KDV dahil toplamı hesaplar
function kdvDahilToplam(fiyatlar, oran = 0.20) {
    // Cursor burada gövdeyi önerir; Tab ile kabul edin
    return fiyatlar.reduce((t, f) => t + f, 0) * (1 + oran);
}

Öneriyi körü körüne kabul etmeyin; özellikle sayısal hesaplarda ve sınır durumlarında kodu okuyun.

2. Satır içi düzenleme (Ctrl+K)

Bir kod bölümünü seçip Ctrl+K (macOS'ta Cmd+K) tuşlarına bastığınızda, yaptırmak istediğinizi doğal dille yazabilirsiniz. Cursor değişikliği fark (diff) olarak gösterir; kabul ya da reddedersiniz.

Seçili fonksiyonu: boş dizide 0 döndürecek, negatif fiyatlarda hata
fırlatacak ve JSDoc açıklaması ekleyecek şekilde güncelle.

Terminalde de Ctrl+K ile "son 3 commit'i göster" gibi bir isteği komuta çevirtebilirsiniz.

3. Agent ve sohbet paneli

Yan paneldeki sohbet/Agent penceresi (Ctrl+L, macOS'ta Cmd+L) daha büyük işler içindir: Agent birden fazla dosyayı okuyup düzenleyebilir, terminal komutu önerebilir ve adımlarını gösterir. Kısayollar sürüme göre değişebildiğinden, farklı davranırsa Ayarlar → Klavye Kısayolları bölümünden kontrol edin.

@ ile doğru bağlam

Yanıt kalitesi, modele hangi bilgiyi verdiğinize bağlıdır. Sohbette @ yazarak bağlam ekleyebilirsiniz:

• @dosya / @klasör – ilgili dosyaları ya da klasörü ekler.
• @Docs – eklediğiniz bir kütüphanenin belgelerini kullanır.
• @Web – güncel bilgi için web araması yapar.

@src/Sepet.php @tests/SepetTest.php
Sepete aynı ürün ikinci kez eklendiğinde adet artmıyor. Hatayı bul,
düzelt ve bu durumu kapsayan bir test ekle.

Gizli dosyaları dışarıda tutun

Proje kökündeki .cursorignore dosyası, belirttiğiniz dosya ve klasörlerin yapay zekâ özelliklerine bağlam olarak gönderilmesini engeller:

.env
config/secrets.php
storage/logs/
*.sql

İpuçları

• Küçük işler için Tab ve Ctrl+K, çok dosyalı işler için Agent kullanın.
• Agent'tan önce plan isteyin, sonra adım adım uygulatın.
• Her değişiklikten sonra testleri çalıştırın ve Git ile commit alın.

Sık yapılan hatalar

• Bağlam vermeden genel sorular sormak; Cursor hangi dosyadan söz ettiğinizi tahmin etmek zorunda kalır.
• Büyük fark (diff) çıktılarını okumadan "Tümünü kabul et" demek.
• Gizli bilgileri içeren dosyaları .cursorignore'a eklemeyi unutmak.

Özet

Cursor'da verimin anahtarı doğru aracı doğru işe kullanmaktır: Tab ile hızlı yazım, Ctrl+K ile hedefli düzenleme, Agent ile çok adımlı görevler ve @ ile doğru bağlam. Sonraki adım olarak projenize özel kurallar tanımlamayı öğrenin.