C++ için GitHub Copilot modernleştirme sorunlarını giderme

Bu makale, C++ projelerinizi yükseltmek için GitHub Copilot modernleştirme kullandığınızda sık karşılaşılan sorunları çözmenize yardımcı olur. Burada ele alınmıyor bir sorunla karşılaşırsanız, Visual Studio'da Help> Geri Bildirim Gönder> Sorun bildir kullanın.

Başlamadan önce

Çözümünüzün veya projenizin derlendiğini doğrulayın

MSVC yükseltme senaryolarında aracı, çözümünüzü veya projenizi oluşturarak değişiklikleri doğrular. Başlamadan önce çözümünüz veya projeniz zaten bozuksa aracı, önceden var olan sorunları yükseltme tarafından ortaya konulmuş sorunlardan ayırt etmede daha güçlük çeker.

Bilinen derleme sorunlarınız varsa bunları özel yönergelerde belgeleyin, aracı değerlendirme aşamasında bağlam istediğinde yanıtınızda iletin veya aracının bunları yok sayacağını bilmesi için bunları scenario-instructions.md öğesine ekleyin.

Kaydedilmemiş işleri işleme veya hazırlama

Temiz bir çalışma diziniyle başlayın. Ajan çalışırken commit’ler oluşturur ve kaydedilmemiş değişiklikleri ajanın değişiklikleriyle karıştırmak, değişiklikleri gözden geçirmeyi veya geri almayı zorlaştırır.

git stash
git status

Git dışı depoları yedekleme

Aracı, kaynak denetimi altında olmayan klasörlerle de çalışabilir. Projeniz git deposunda değilse aracı dallanma ve işleme işlemlerini atlar. Gerekirse geri yükleyebilmeniz için başlamadan önce proje klasörünüzü yedekleyin.

Tip

Uzak bir depoya göndermeseniz bile başlamadan önce yerel bir Git deposu başlatmayı göz önünde bulundurun. Bu, tek tek değişiklikleri geri almak ve ilerleme durumunu adım adım izlemek için size bir yol sağlar.

Örnek:

git init
git add
git commit -m "Initial Commit"

Siz ve aracı işinizi tamamladığınızda, Git’i kullanmaya devam etmek istemiyorsanız çalışma ağacınızdaki kodun istediğiniz gibi olduğundan emin olun ve git init komutunu çalıştırdığınız dizindeki .git dizinini silin.

Sık karşılaşılan sorunlar

Aracı, Copilot Chat’te görünmüyor

Symptoms: GitHub Copilot sohbet penceresine @Modernize yazmak aracıyı etkinleştirmez veya ModernizeÇözüm Gezgini bağlam menüsünde görünmez.

Çözümler:

  1. Help>About Microsoft Visual Studio içinde Visual Studio sürüm 18.7 veya üzeri olduğunu doğrulayın.
  2. Durum çubuğundaki Copilot simgesini denetleyerek GitHub Copilot etkin olduğunu doğrulayın.
  3. Özelliğin Tools>Options>GitHub>Copilot>C/C++ bölümünde etkin olduğundan emin olun. Ardından C++ için GitHub Copilot modernleştirmesini etkinleştir seçeneğini belirleyin.
  4. Ayarları değiştirdikten sonra Visual Studio yeniden başlatın.

Aracı döngüye takılıyor

Belirtiler: Araç, ilerleme kaydetmeden aynı düzeltmeyi tekrar tekrar dener.

Çözümler:

  • Copilot Chat istemi penceresindeki iptal düğmesiyle aracıyı durdurun, istemde neleri gözlemledığınızı açıklayın ve aracıyı sürdürme istemini gönderin.
  • El ile düzeltme sağlayın ve aracıya neleri değiştirdiğinizden bahsedin. Ajan, düzeltmelerinizden öğrenir.
  • Ajana başka bir yaklaşım denemesini isteyin. Örneğin, GitHub Copilot sohbet penceresine yazın: "Bu düzeltme çalışmıyor. Farklı bir strateji deneyin."
  • Gerekirse, son değişiklikleri eski hâline döndürün veya geri alın ve görevi yeniden başlatın.

Büyük çözümler çok uzun sürüyor

Belirtiler: Birçok proje içeren büyük bir çözümün yükseltmesi çok uzun sürüyor veya duraklıyor gibi görünüyor.

Çözümler:

  • Pilot olarak tek bir temsili projeyle başlayın. Bu, sistemik sorunları erken ortaya çıkar.
  • .github/upgrades/{SCENARIO ID} içinde tasks.md gözden geçirerek ilerlemeyi izleyin.
  • Oturum zaman aşımına uğradıysa yeni bir oturum başlatın. Yazılım aracı kaldığı yerden devam eder.

Kurtarma stratejileri

Tüm değişiklikleri geri alma

Yükseltme için bir Git dalı kullandıysanız, her şeyi geri alın:

git checkout your-original-branch
git branch -D upgrade-branch

Özgün kodunuz dokunulmamış.

Son değişikliği geri alma

En son işlemeyi geri alın:

git revert HEAD

Ya da temsilciye söyleyin, Revert the last change.

Belirli bir aşamadan yeniden başlatma

Ajanın planı işe yaramıyorsa, aşağıdakine benzer bir istem göndererek daha önceki bir aşamadan yeniden başlayın:

  • Let's redo the plan. I want a different approach to the conformance issues.
  • Go back to the assessment and reconsider the upgrade strategy.

Yeni bir başlangıç

.github/upgrades/{SCENARIO ID} Klasörü silin ve aracıyla yeni bir konuşma başlatın. Sıfırdan başlıyor.

Yardım alın

Bir sorunu çözemiyorsanız:

  1. Help>Destek Gönder> Sorun bildir Visual Studio kullanın.
  2. Mümkünse, .github/upgrades/{SCENARIO ID} içindeki execution-log.md içeriğini ekleyin.

İlgili içerik

  • Last updated on