Başka bilgisayarda açılmayan projede önce çalışma zamanı, bağımlılık kilidi ve yerel ayar farklarını karşılaştırın. Kodu yeniden yazdırmak çoğu zaman yanlış başlangıçtır. Aynı kaynak farklı Node.js sürümüyle, eksik ortam değişkeniyle veya farklı çalışma dizininden başlatıldığında farklı davranabilir.
Yeni bilgisayarda başarıyla açılan projenin kurulum komutunu ve zorunlu ayar adlarını README’ye yazın. Böylece sonraki kurulumu sohbet geçmişini aramadan yapabilirsiniz. Bir paket değişikliği gerekiyorsa kilit dosyasını da aynı değişiklikle güncelleyin; bir bilgisayarda çalışan gizli durumun kurulum talimatı yerine geçmesine izin vermeyin.
Neyi taşımanız gerektiğini ayırın
Kaynak kod, bağımlılık tanımı ve kilit dosyası projenin tekrar kurulmasını sağlar. Bilgisayarınızda kurulmuş paket klasörü ise aynı işletim sistemi ve işlemciyi varsayabilir. Gizli bilgileri paylaşmadan gerekli ayar adlarını gösteren bir örnek dosya hazırlamak, çalışır ortamın hangi değerlere ihtiyaç duyduğunu açıklar.Aynı kurulum koşulunu oluşturun
- Doğru klasörde olduğunuzu kontrol edin. Paket tanımının bulunduğu proje kökünde çalışın. Bir üst klasörde komut vermek, dosya yok veya betik bulunamadı hatası üretebilir.
- Çalışma zamanı sürümünü karşılaştırın. Örneğin Node.js projesinde node --version ve npm --version çıktısını alın. Projenin tanımladığı sürüm koşuluna uygun bir kurulum kullanın.
- Kilit dosyasından kurun. npm kullanan ve package-lock.json bulunan projede npm ci, kilit ile paket tanımı uyumluysa temiz kurulum yapar. Bu komut mevcut node_modules klasörünü yeniden kurar; kaydedilmemiş özel dosyanızı paket klasöründe tutmayın.
- Ortam ayarlarını tamamlayın. .env.example benzeri dosyadaki isimleri yerel yapılandırmanıza aktarın. Örnek dosyaya gerçek parola yazmayın. Gerekli değer yoksa uygulamanın hangi alanı beklediğini hata metninden bulun.
- Tanımlı başlatma komutunu çalıştırın. package.json betiklerini okuyun. Geliştirme sunucusu ile üretim derlemesini birbirine karıştırmayın; varsa derleme adımını ayrıca deneyin.
Hangi hata hangi katmana işaret eder?
“Module not found” bağımlılığa veya yanlış dosya yoluna; “missing environment variable” ayara; “address already in use” kullanılan porta işaret edebilir. Hata sınıfını belirlemeden bütün paketleri yükseltmek, ilk soruna ikinci bir uyumsuzluk ekleyebilir.Yeni bilgisayarda başarıyla açılan projenin kurulum komutunu ve zorunlu ayar adlarını README’ye yazın. Böylece sonraki kurulumu sohbet geçmişini aramadan yapabilirsiniz. Bir paket değişikliği gerekiyorsa kilit dosyasını da aynı değişiklikle güncelleyin; bir bilgisayarda çalışan gizli durumun kurulum talimatı yerine geçmesine izin vermeyin.
