Kopyala yapıştır kod neden çalışmıyor? Çünkü kaynak kod aynı görünse bile kullanılan programlama dili, çalışma ortamı, girdi verisi, dosya yolu veya bağımlılıklar farklı olabilir. Bu nedenle sorunu çözmeye çalışırken kodu rastgele değiştirmek yerine önce hangi koşulun değiştiğini belirlemek gerekir.
İlk inceleme, hata mesajını aynen okumak ve kodu çalıştırdığın koşulları kaynak kodun hazırlandığı koşullarla karşılaştırmaktır. Böylece sorunun sözdiziminden mi, isimlendirmeden mi, veriden mi yoksa ortamdan mı kaynaklandığını daha düzenli biçimde ayırabilirsin.
Kopyala Yapıştır Kod Neden Çalışmıyor? Önce Farkları Karşılaştır
Kodu çalıştırmadan önce aşağıdaki başlangıç kontrol listesini kullan. Her madde, kaynak kod ile kendi çalıştırma koşulların arasındaki farkları ortaya çıkarmaya yardım eder.
- Programlama dili: Dosyanın gerçekten kullandığın dille yazıldığını ve doğru dosya türüyle çalıştırıldığını kontrol et.
- Derleyici veya yorumlayıcı: Kodu hangi derleyici ya da yorumlayıcıyla çalıştırdığını belirle. Çalıştırma komutunun doğru dosyaya yöneldiğinden emin ol.
- Çalışma ortamı: Kodun hangi klasörde, hangi editörde veya hangi terminal oturumunda çalıştığını kontrol et. Aynı dosya, farklı bir çalışma klasöründe farklı sonuç verebilir.
- Girdi verisi: Kullanıcıdan alınan metni, sayıları veya dosya içeriğini kaynak örnekteki verilerle karşılaştır. Boş değer, farklı biçimde yazılmış sayı veya beklenmeyen karakter sonucu değiştirebilir.
- Dosya yolları: Okunan dosyanın adı, klasörü ve göreli yolu doğru mu? Dosya kendi bilgisayarında farklı bir konumda olabilir.
- Bağımlılıklar: Kodun çağırdığı modül, sınıf, fonksiyon veya yardımcı dosyanın erişilebilir olduğunu kontrol et. Eksik bir
importya da yanlış isim, kodun daha ilk aşamada durmasına neden olabilir.
Bu karşılaştırmada amaç hemen bir çözüm tahmin etmek değil, farklı olan ilk koşulu bulmaktır. Birden fazla fark varsa önce hata mesajında açıkça belirtilen noktayı incelemek daha sağlıklı bir başlangıç sağlar.
1. Aşama: Hata Mesajını Aynen Oku
Hata mesajını yalnızca son satırdan ibaret görme. Mesajın tamamında genellikle satır veya konum bilgisi, hata türü ve sorunla ilişkili değişken, fonksiyon ya da dosya adı bulunur. Ekran görüntüsüne bakmak yerine metni satır satır okumak, hangi inceleme noktasına geçmen gerektiğini gösterir.
Önce şu kontrol sorularını yanıtla:
- Hata hangi satırda veya hangi konumda duruyor?
- Mesajda hangi isim, değişken, fonksiyon, dosya ya da işlem belirtiliyor?
- Hata, kod çalıştırılmadan önce mi oluşuyor, yoksa program çalışırken belirli bir adımda mı ortaya çıkıyor?
Karar akışı: Sözdizimi veya girinti sinyali varsa belirtilen satırla birlikte bir önceki satırı da incele. İsim veya import sinyali varsa değişken, fonksiyon ve bağımlılık adlarına geç. Veri ya da işlem sinyali varsa kullanılan veri türünü ve girdinin gerçek değerini kontrol et.
Aşağıdaki küçültülmüş örnekte çalışan kod ile beklenen sonuç açıkça görülebilir:
def toplam(a, b):
return a + b
sayi1 = 4
sayi2 = 6
print(toplam(sayi1, sayi2))Beklenen çıktı 10 değeridir. Fonksiyon çağrısında toplam yerine farklı bir isim yazılırsa, hata mesajındaki isim bölümü sana hangi adın bulunamadığını gösterir. Böylece tüm programı değiştirmek yerine önce belirtilen adı inceleyebilirsin.
2. Aşama: En Küçük Tekrar Üretilebilir Örneği Oluştur
Kopyalanan kodu düzeltmenin ilk adımı yeni satırlar eklemek değildir. Önce hatayı en küçük tekrar üretilebilir örneğe indirmek gerekir. Böylece sorunun arayüzden, fazla girdiden, kullanılmayan bir fonksiyondan ya da dış dosyadan mı kaynaklandığı daha kolay anlaşılır.
Çalışmayan kodun geçici bir kopyasını oluştur ve şu parçaları sırayla ayır:
- Kullanılmayan fonksiyonları ve sınıfları kaldır.
- Arayüz, menü veya görsel bileşenleri geçici olarak devre dışı bırak.
- Fazla girdileri azalt ve tek bir örnek veriyle dene.
- Mümkünse dosya, ağ bağlantısı veya başka dış kaynak gerektiren bölümleri ayır.
- Hatayı koruyan en kısa işlem akışını bırak.
Kontrol soruları: Hata hangi en küçük girdide hâlâ sürüyor? Hangi satır kaldırılınca hata kayboluyor? Aynı kod aynı koşullarda tekrar çalıştırıldığında aynı sonuç oluşuyor mu?
Hata küçültülmüş örnekte de sürüyorsa kalan satırlara odaklan. Hata kayboluyorsa kaldırdığın bağımlılıkları tek tek geri ekle. Sorun yeniden ortaya çıktığı anda son eklediğin parçayı daha ayrıntılı incele. Bu yöntem, aynı anda birçok olası nedeni değiştirmek yerine tek bir değişkeni izlemeyi sağlar.
3. Aşama: İsimleri, Girintiyi ve Veri Türlerini Kontrol Et
Kod küçüldükten sonra değişken ve fonksiyon adlarını satır satır karşılaştır. Bir isim tanımlandığı hâlde bulunamıyorsa yazım farkı, büyük ve küçük harf kullanımı, alt çizgi veya kapsam değişikliği olabilir. Aynı adın farklı bölümlerde farklı değerlerle kullanılması da hatayı zorlaştırabilir.
İsimle ilgili bir hata gördüğünde şu soruları sor: Tanım ile kullanım tamamen aynı mı? Değişken, kullanıldığı satırdan önce oluşturulmuş mu? Aynı isim başka bir kapsamda yeniden tanımlanmış mı? Cevap olumsuzsa adı tutarlı hâle getir veya değişkenlerin kapsamını ayır.
Blok yapısını da kontrol et. Python'da girinti, kodun hangi bloğa ait olduğunu belirler. Diğer dillerde ise parantezler ve blok seviyeleri benzer bir düzen kurar. Bir koşul, döngü veya fonksiyon bloğunun açılıp doğru yerde kapanıp kapanmadığını incele. Blok hatası varsa girintiyi, parantezleri veya blok seviyesini hizala.
Son olarak işlem ile veri türünün uyuşup uyuşmadığına bak. Metin, sayı, liste ve nesne aynı işlemlerde kullanılmaz. Sayı bekleyen bir işlem metin alıyorsa dönüşümü açıkça yap veya girdiyi doğrudan beklenen türde üret. Tür hatası sürüyorsa değerin yalnızca tanımına değil, hatadan önce hangi işlemle değiştiğine de bak.
4. Aşama: Eksik Bağımlılıkları ve Ortam Farklarını Ayır
Kodun bir ortamda çalışıp başka bir ortamda çalışmaması, her zaman kod mantığının hatalı olduğu anlamına gelmez. Bu aşamada eksik import veya paket, çalışma dizini ve dosya yolu, ortam değişkenleri ile kütüphane API'si ve sürüm farklarını ayrı ayrı test et.
Önce hata veren satırdaki isimleri incele. Kullanılan isim dosyada tanımlı mı, doğru biçimde içe aktarılmış mı ve gerekli paket çalıştırdığın ortamda gerçekten kurulu mu? Kodun kaynak ortamında çalışması, senin kullandığın yorumlayıcı veya derleyicide aynı bağımlılıkların bulunduğunu göstermez. İlgili import satırını ve tek bir çağrıyı içeren küçültülmüş bir örnek çalıştırmak, sorunun bağımlılıkta mı yoksa ana mantıkta mı olduğunu ayırmaya yardımcı olur.
Dosya yolu hatalarında çalışma dizinini kontrol et. Göreli bir yol, programın kaynak dosyasının bulunduğu klasöre değil, programın başlatıldığı çalışma dizinine göre çözülebilir. Dosyanın gerçekten var olup olmadığını, adında büyük ve küçük harf farkı bulunup bulunmadığını ve yolun hangi çalışma dizinine göre çözüldüğünü kontrol et. Ortam değişkenlerinde ise değişkenin tanımlı, doğru adlandırılmış ve beklenen değeri taşıyıp taşımadığını incele.
Kütüphane sürümlerini iki ortamda karşılaştır. Fark varsa kullandığın API adını, parametrelerini ve çağrı biçimini ilgili belgelerdeki biçimle doğrula. Yapay zekâ aracından alınan kodu doğrudan doğru kabul etme. Kodda geçen import, paket, sınıf, fonksiyon ve dosyaları tek tek kontrol et; önce küçük ve sabit bir girdide çalıştır.
Kontrol soruları: Hata yalnızca tek bir ortamda mı oluşuyor? Bağımlılık gerçekten kurulu mu? Dosya yolu hangi çalışma dizinine göre çözülüyor?
Karar: Sorun ortam kaynaklıysa bağımlılıkları, çalışma dizinini ve test girdisini açıklaştırıp yeniden çalıştır. Aynı küçük örnek beklenen sonucu veriyorsa üçüncü aşamadaki isim ve veri türü kontrollerine dön.
5. Aşama: Beklenen ve Gerçek Çıktıyı Karşılaştır
Son aşamada programı çalıştırmadan önce aynı girdi ve çalışma koşulları için beklenen çıktıyı yaz. Ardından gerçek çıktıyı bununla karşılaştır. Farkı biçim, veri, sıra, dosya içeriği veya hesaplama olarak sınıflandırmak, incelemeyi daraltır.
- Biçim: Boşluk, satır sonu veya büyük ve küçük harf farkı var mı?
- Veri: Değerin türü veya içeriği beklediğin gibi mi?
- Sıra: Sonuçlar doğru ancak farklı sırada mı geliyor?
- Dosya içeriği: Okunan ya da yazılan dosya gerçekten beklenen içerikte mi?
- Hesaplama: İlk yanlış değer hangi işlemden sonra oluşuyor?
Kontrol soruları: Girdi aynı mı? Veri türü dönüşümü yapıldı mı? İlk farklı değer hangi satırda oluştu?
Örneğin metin olarak gelen değerleri sayıyla toplamak hata oluşturabilir:
ilk = "5"
ikinci = 7
toplam = ilk + ikinci
print(toplam)Burada ilk bir metin, ikinci ise sayıdır. İki değeri de sayıya dönüştürerek işlem yapılabilir:
ilk = int("5")
ikinci = int("7")
toplam = ilk + ikinci
print(toplam)Beklenen çıktı:
12Beş aşamalı kontrol listesi: Hata mesajını aynen oku, en küçük örneği oluştur, isimleri ve veri türlerini kontrol et, ortam farklarını ayır, beklenen ve gerçek çıktıyı karşılaştır; yeni satırlar eklemek yerine ilk sapmayı izle, tek bir değişiklik yap ve yeniden çalıştır.
Sık Sorulan Sorular
Hata mesajı yok ama programın çıktısı yanlışsa nasıl ilerlemeliyim?
Aynı girdiyi yeniden kullanarak beklenen çıktıyı önceden yaz. Gerçek çıktıyla karşılaştır, ilk farklı değerin oluştuğu satıra dön ve veri türü, işlem sırası ile kullanılan değişkenleri kontrol et.
Kopyaladığım kod başka bir bilgisayarda çalışıyor, bende neden çalışmıyor?
Çalıştırılan dil ortamını, bağımlılıkları, çalışma dizinini, dosya yollarını, ortam değişkenlerini ve girdileri karşılaştır. Küçük bir örneği iki ortamda aynı koşullarla çalıştırmak farkın kaynağını daraltır.
Yapay zekâdan aldığım kodun doğru olup olmadığını nasıl kontrol ederim?
Importları, değişkenleri, fonksiyonları ve kütüphane çağrılarını tek tek doğrula. Kodu küçük ve sabit bir girdide çalıştır, beklenen çıktıyı kendin belirle ve ilk sapmayı bulmadan yeni kod ekleme.
Hata ayıklamada amaç yalnızca hatayı susturmak değil, ilk sapmanın nedenini bulup kodun nasıl çalıştığını anlayabilmektir.
