Büyük kod tabanlarıyla çalışma
Büyük kod tabanlarında gezinme ve çalışma stratejileri
Büyük kod tabanlarıyla çalışmak, bağlam sınırlamalarını yönetmek ve üretkenliği korumak için belirli stratejiler gerektirir. Bu kılavuz, Verdent for VS Code kullanarak büyük projelerde verimli bir şekilde gezinmek, anlamak ve değişiklik yapmak için pratik iş akışları sunar.
Kod tabanı keşfi için Explorer aracısını kullanma
Diyelim ki büyük bir kod tabanına yenisiniz ve belirli bir işlevin nerede uygulandığını bulmanız gerekiyor.
Geniş kapsamlı keşif soruları sorun
Where is user authentication handled in this codebase?Verdent kod tabanı aramaları için token açısından verimli bir uzman olan Explorer aracısına otomatik olarak görev devreder.
Explorer verimli bir şekilde arama yapar
Explorer aracısı şunları yapar:
- Dosya adlarını ve yollarını arar
- Anahtar kelimeler için kod içeriğinde grep yapar
- Mimari kalıpları analiz eder
- Sonuçları dosya yolları ve kod parçacıklarıyla döndürür
Aramanızı daraltın
Show me all files that import the authentication moduleExplorer, sonuçları daraltmak için takip aramaları yapabilir.
Karmaşık aramaları paralelleştirin
Kapsamlı keşif için Verdent birden fazla Explorer aracısını paralel olarak çalıştırabilir:
- Explorer 1: Kimlik doğrulama mantığını bul
- Explorer 2: Yetkilendirme mantığını bul
- Explorer 3: Oturum yönetimini bul
Sonuçlar paralel arama sayesinde daha hızlı gelir.
İpuçları:
- Explorer aracısı, ana bağlamı doldurmadan büyük kod tabanlarında verimli çalışır
- Birden fazla Explorer aracısı farklı yönleri aynı anda arayabilir
- Kalıp eşleştirme ve mimari keşif için Explorer'ı kullanın
- Sonuçlar, bağlam için dosya yolları ve ilgili kod parçacıklarını içerir
Görevleri yönetilebilir parçalara bölme
Diyelim ki büyük bir kod tabanında çalışıyorsunuz ve birçok dosyayı etkileyen bir özellik eklemeniz gerekiyor.
Doğal görev sınırlarını belirleyin
Her şeyi aynı anda istemek yerine:
Phase 1: Add the data models for the notification systemÖnce tek bir bağımsız bileşene odaklanın.
Aşamayı tamamen tamamlayın
Aşama 2'ye geçmeden önce, test dahil olmak üzere Aşama 1'i tamamen tamamlayın. Bu, temiz bir kontrol noktası oluşturur.
İlerlemenizi commit'leyin
git add .
git commit -m "feat: add notification data models"Commit yapmak, güvenli bir geri alma noktası oluşturur.
Sonraki aşama için bağlamı temizleyin
Karmaşık görevler için, sonraki aşamaya geçmeden önce bağlamı temizleyin. Bu, Verdent zirvedeki performansını korumak için yeterli bağlam kapasitesine sahip olmasını sağlar.
Phase 2: Build the notification API endpoints using the data modelsYalnızca Aşama 2'ye odaklanmış, temiz bağlamla yeni bir oturum başlatın.
İpuçları:
- Doğal kesme noktaları bağlam tükenmesini önler
- Her aşama bağımsız olarak test edilebilir olmalıdır
- Aşamalar arasında commit yapmak güvenli denemeye olanak tanır
- Yeni oturumlar bağlamı temiz ve odaklanmış tutar
Büyük ölçekli değişiklikler için Plan Mode'dan yararlanma
Diyelim ki büyük bir kod tabanında onlarca dosyaya dağılmış bir özelliği yeniden düzenlemeniz gerekiyor.
Plan Mode ile başlayın
Switch to Plan Mode: Refactor the payment processing logic to use a new payment provider across all filesPlan Mode, dosya değişikliklerinde bağlam tüketmeden salt okunur analiz yapmanıza olanak tanır.
Etkilenen tüm dosyaları bulmak için Explorer'ı kullanın
Use the Explorer agent to find all files that reference payment processingGüncellenmesi gereken her konumu keşfetmenizi sağlar.
Kapsamlı planı inceleyin
Verdent şunları gösteren bir plan sunar:
- Değişiklik gerektiren tüm dosyalar (25 dosya belirlendi)
- Ana bağlama dahil edilecek minimum dosya seti
- İşlem sırası
- Değişiklikler arasındaki bağımlılıklar
Yaklaşıma karar vermeden önce inceleyin.
Yürütmeyi onaylayın
Plandan memnun kaldığınızda, yürütmeyi onaylayın. Verdent değişiklikleri metodik bir şekilde işler.
İpuçları:
- Plan Mode, yürütmeden önce minimum dosya setlerini belirlemeye yardımcı olur
- Explorer, büyük ölçekli yeniden düzenlemede hiçbir dosyanın atlanmamasını sağlar
- Planlar, bağlam tüketilmeden önce kapsamı açıkça gösterir
- Belgeleme ve ekip incelemesi için planları dosyalara kaydedin
Birçok dosyada koordineli değişiklikler yapma
Diyelim ki büyük bir kod tabanında 50'den fazla dosyada kullanılan bir işlevi yeniden adlandırmanız gerekiyor.
Tüm kullanımları bulmak için Explorer'ı kullanın
Use the Explorer agent to find all files that use the calculateTotal functionGüncelleme gerektiren her dosyayı belirler.
Kapsamı Plan Mode ile inceleyin
In Plan Mode: Rename calculateTotal to computeFinalTotal across all filesDeğişiklik yapmadan önce tüm kapsamı görün.
Hiçbir dosyanın atlanmadığını doğrulayın
Verdent güncelleme gerektiren 52 dosyanın tamamını gösterir. Eksiksizliği sağlamak için listeyi inceleyin.
Koordineli değişiklikleri yürütün
Planı onaylayın. Verdent tüm dosyaları sistematik olarak günceller ve her yerde tutarlı yeniden adlandırma sağlar.
Doğrulamak için testleri çalıştırın
Run the full test suite to verify all references were updated correctlyTestler atlanmış referansları yakalar.
İpuçları:
- Explorer, büyük ölçekli değişikliklerde hiçbir dosyanın atlanmamasını sağlar
- Plan Mode yürütmeden önce tüm kapsamı gösterir
- Sistematik güncellemeler tüm dosyalar arasında tutarlılığı korur
- Büyük ölçekli yeniden düzenlemeden sonra kapsamlı test yapın
Birçok dosyada koordineli değişiklikler aşamalar halinde daha güvenlidir; bir katmanı güncelleyin, doğrulayın, ardından bağımlı katmanlara geçin.
Sıkça sorulan sorular
Bağlam sınırlarına yaklaştığımı nasıl anlarım?
İşaretler arasında daha yavaş yanıt süreleri, birkaç saat süren oturumlar veya birçok büyük dosyanın yüklenmesi yer alır. Oturum uzunluğunuzu ve dosya sayınızı izleyin. Performans düşüşü fark ettiğinizde, mevcut görevinizi tamamlayın, ilerlemenizi commit'leyin ve temiz bir bağlamla yeni bir oturum başlatın.
Verdent'in aynı anda onlarca dosyayı değiştirmesine izin vermek güvenli mi?
Evet, doğru kullanıldığında güvenlidir. Önce tüm kapsamı incelemek için her zaman Plan Mode'u kullanın, kapsamlı test kapsamına sahip olduğunuzdan emin olun ve aşamalar arasında sık sık commit yapın. Bu, değişiklikleri aşamalı olarak doğrulamanıza ve gerekirse kolayca geri almanıza olanak tanır.
Explorer aracısını mı yoksa dosyaları doğrudan yüklemeyi mi ne zaman kullanmalıyım?
Ana bağlamı tüketmeden keşif ve arama görevleri için Explorer aracısını kullanın. Yalnızca değiştirmeniz gerektiğinde dosyaları doğrudan @-mention ile yükleyin. Explorer "şu özelliğe sahip tüm dosyaları bul..." soruları için idealdir, @-mention ise "bu belirli dosyayı güncelle" görevleri içindir.
Büyük kod tabanı çalışmaları için hangi model ön ayarı en iyisidir?
Karmaşık çok dosyalı işlemler ve yeniden düzenleme için Performance ön ayarını kullanın. Basit aramalar ve keşif görevleri için Efficiency ön ayarını kullanın. Performance, koordineli değişiklikler için daha fazla akıl yürütme yeteneği sağlarken, Efficiency keşif için daha hızlı ve daha uygun maliyetlidir.