Sorun Giderme ve SSS
Bir şey ters gittiğinde önce bu sayfaya göz at. Burada çözümü yoksa GitHub Issues sayfasından ya da program içinden Yardım → Hata Bildir / Öneri Gönder ile bildirebilirsin.
Program açılmıyor
Bölüm başlığı “Program açılmıyor”“Program başlatılıyor…” ekranında kalıyor ya da hata veriyor
Bölüm başlığı ““Program başlatılıyor…” ekranında kalıyor ya da hata veriyor”TürKod iki parçadan oluşur: gördüğün arayüz ve kodunu çalıştıran arka plan programı. Açılış ekranı, arka plan programı hazır olana kadar bekler. Başlatılamazsa ekranda turuncu bir uyarı ve iki düğme çıkar:
- Yeniden dene — arka plan programını yeniden başlatmayı dener. Çoğu zaman bu yeterlidir.
- Yine de aç — arayüzü açar; ancak çalıştırma, düzeltme gibi özellikler bağlantı kurulana kadar çalışmaz.
Sorun sürerse ayrıntılar %LOCALAPPDATA%\TurKod\backend.log dosyasındadır. Hata bildirirken bu dosyayı eklemen işi çok hızlandırır.
“Windows bilgisayarınızı korudu” uyarısı
Bölüm başlığı ““Windows bilgisayarınızı korudu” uyarısı”Bu, Windows’un az indirilen programlar için gösterdiği standart uyarıdır. Dosyayı resmî bağlantıdan indirdiysen Ek bilgi → Yine de çalıştır’a bas. Dosyanın değiştirilmediğinden emin olmak için Güvenlik sayfasına bak.
32-bit Windows ya da Windows 7/8 kullanıyorum
Bölüm başlığı “32-bit Windows ya da Windows 7/8 kullanıyorum”TürKod yalnızca 64-bit Windows 10 ve 11 üzerinde çalışır. Bkz. Gereksinimler. Bu durumda kurulum yapmadan Canlı Demo ile temel konuları deneyebilirsin.
Kod çalışmıyor
Bölüm başlığı “Kod çalışmıyor”Durum çubuğunda kırmızı bir hata var
Bölüm başlığı “Durum çubuğunda kırmızı bir hata var”Kod çalıştırılmadan önce denetlenir. Hata satır numarasıyla (örn. Satır 1: ':' bekleniyor) gösterilir ve satır editörde kırmızıyla işaretlenir. En sık nedenler:
- Satır sonunda
:unutulmuş (eğer,için,döngü,fonksiyon,sınıfsatırlarında gerekir). - Parantez ya da tırnak kapanmamış.
- Girinti (satır başındaki boşluk) hatalı.
Araç çubuğundaki Düzelt (sihirli değnek) bunların çoğunu otomatik düzeltir 👉 Akıllı Düzeltme
“Tanımsız İsim Hatası” diyor
Bölüm başlığı ““Tanımsız İsim Hatası” diyor”Bir kelimeyi yanlış yazmış olabilirsin. Sözlükte olmayan bir kelime hata vermeden aynen geçer ve çalışırken Tanımsız İsim Hatası (NameError) üretir. Doğru yazımı Sözlük sayfasında ya da Araçlar → Kod Arama Çevirici ile bulabilirsin. Otomatik tamamlamanın 📚 önerileri de doğru yazımı gösterir.
Program bitmiyor / donmuş gibi
Bölüm başlığı “Program bitmiyor / donmuş gibi”- Program büyük ihtimalle senden girdi bekliyordur: terminalin en altındaki kutuda Programa girdi… yazıyorsa cevabını yazıp
Enter’a bas. - Sonsuz döngüye girdiyse kırmızı ⏹️ Durdur düğmesine ya da terminalde
Ctrl+C’ye bas.
Dosya okuyamıyorum / yazdığım dosya kayboldu
Bölüm başlığı “Dosya okuyamıyorum / yazdığım dosya kayboldu”Kaydedilmemiş bir sekme her çalıştırmada geçici bir klasörde çalışır. Önce dosyanı kaydet: kaydedilmiş dosyalar kendi klasörlerinde çalışır ve yanındaki dosyaları adlarıyla ("notlar.txt") açabilir. Bkz. Çalıştırma ve Hata Ayıklama.
“Modül Bulunamadı Hatası”
Bölüm başlığı ““Modül Bulunamadı Hatası””Kullandığın kütüphane kurulu değildir. Terminale pip yükle kütüphane_adı yaz. Bkz. Terminal ve Paketler.
Ayarlar ve veriler
Bölüm başlığı “Ayarlar ve veriler”Ayarlarım nerede saklanıyor?
Bölüm başlığı “Ayarlarım nerede saklanıyor?”| Ne? | Nerede? |
|---|---|
| Ayarlar, açık sekmeler (oturum), AI anahtarı | %USERPROFILE%\.turkod_ayarlar.json |
pip yükle ile kurulan kütüphaneler |
%LOCALAPPDATA%\TurKod\pip_packages |
| Günlük (log) dosyası | %LOCALAPPDATA%\TurKod\backend.log |
Ayar dosyası bozulursa TürKod onu .turkod_ayarlar.json.bozuk adıyla yedekler ve varsayılan ayarlarla açılır.
Ayarları sıfırlamak istiyorum
Bölüm başlığı “Ayarları sıfırlamak istiyorum”TürKod kapalıyken %USERPROFILE%\.turkod_ayarlar.json dosyasını sil. Program bir sonraki açılışta varsayılan ayarlarla başlar (açık sekmelerin ve AI anahtarın da silinir).
Arayüz turunu kaçırdım
Bölüm başlığı “Arayüz turunu kaçırdım”Yardım → Arayüz Turu ile istediğin zaman yeniden başlatabilirsin.
AI Asistan
Bölüm başlığı “AI Asistan”Açıkla / Optimize et çalışmıyor
Bölüm başlığı “Açıkla / Optimize et çalışmıyor”- Ayarlar → AI Asistan’da AI Aktif açık mı, API Key girili mi kontrol et ve Kaydet ve Uygula’ya bas.
- Sağlayıcının kütüphanesi eksikse asistan hangi
pip yüklekomutunu yazman gerektiğini söyler. - İnternet bağlantını ve sağlayıcı hesabındaki kotayı kontrol et.
Ayrıntılar: AI Asistan
Güncelleme
Bölüm başlığı “Güncelleme”“Güncelleme denetlenemedi” diyor
Bölüm başlığı ““Güncelleme denetlenemedi” diyor”İnternet bağlantını kontrol et ve Güncelleştirmeler → Güncelleştirmeleri Denetle ile tekrar dene. Kurum ağlarında GitHub erişimi kısıtlı olabilir; bu durumda yeni sürümü Sürüm Geçmişi sayfasından elle indirebilirsin.
Bir sürümü “Atla” dedim, geri getirmek istiyorum
Bölüm başlığı “Bir sürümü “Atla” dedim, geri getirmek istiyorum”Atladığın sürüm otomatik denetimde sorulmaz ama Güncelleştirmeleri Denetle ile elle baktığında yine görünür.