Neden bu üçlü: VS Code + Git + Node.js?

Kodlama öğrenirken en büyük hız kazancı, “çalışan bir geliştirme ortamını” erken kurmaktan gelir. Bu rehberin hedefi; editörünüzü (VS Code), sürüm kontrolünüzü (Git) ve JavaScript çalışma ortamınızı (Node.js) kurup doğrulamak ve en sonunda küçük bir projeyi çalıştırmaktır.

Not: Node.js sürümleri sık güncellenir. Bu yüzden bu yazıda belirli bir sürüm numarası vermek yerine, yayın tarihinde Node.js resmi indirme sayfasındaki LTS seçeneğini tercih etmenizi öneriyoruz.

Başlamadan önce: Kısa kontrol listesi

• Bilgisayar: Windows, macOS veya Linux
• İnternet bağlantısı (kurulum dosyaları ve güncellemeler için)
• Temel hedef: Terminalden code, git, node ve npm komutlarının çalışması

Kurulum adımlarında takılırsanız, her aracın resmi dokümantasyonuna yönlendiren bağlantılar da ekledim.

1) VS Code kurulumu (ve “code” komutunu aktif etme)

Visual Studio Code, başlangıç için güçlü bir editördür; dahili terminali, eklenti ekosistemi ve Git entegrasyonu ile hızlı ilerlemeyi kolaylaştırır.

Resmi kurulum dokümanı: Aşağıdaki bağlantı VS Code’un Windows kurulum sayfasıdır; aynı dokümantasyon içinde macOS ve Linux kurulum sayfalarına da yönlendirmeler bulunur. Kendi işletim sisteminiz için ilgili sayfayı takip edin: Install VS Code (Visual Studio Code Docs).

Windows

• Resmi kurulum sayfasından indirip yükleyin.
• Kurulum sırasında “PATH’e ekle” benzeri seçenekler sunuluyorsa, bunu seçmek terminalden VS Code açmayı kolaylaştırır.

macOS

• Genellikle uygulamayı “Applications” klasörüne taşıma akışı kullanılır.
• Terminalden code komutunu kullanmak için VS Code içinde ilgili komut/menü ile kabuk komutunu kurmanız gerekebilir (en güncel adımlar için resmi dokümanı kullanın).

Linux

• Dağıtıma göre paket yöneticisi veya paket dosyası (ör. .deb/.rpm) akışı değişir.
• Kurulum varyasyonları için resmi dokümanı izleyin.

Doğrulama: VS Code’u terminalden açın

Kurulumdan sonra bir terminal açın ve şu komutları deneyin:

• VS Code sürümünü görmek: code --version
  Beklenen: Terminale bir sürüm numarası yazdırılır.
• Bulunduğunuz klasörü VS Code’da açmak: code .

İpucu: “code komutu bulunamadı” benzeri bir durum görürseniz, bu genellikle PATH ayarı veya VS Code’un kabuk komutunun etkin olmamasıyla ilgilidir. Resmi kurulum dokümanındaki “code CLI”/PATH adımlarına geri dönün.

2) Git kurulumu ve ilk yapılandırma

Git, yaptığınız değişiklikleri sürüm sürüm kaydetmenizi sağlar. Tek başınıza öğrenirken bile geri alabilme, deneme yapabilme ve ilerlemenizi takip etme açısından çok değerlidir.

Kurulum sonrası commit atabilmek ve commit’lerin kime ait olduğunu belirtebilmek için kimlik bilgilerini ayarlamak özellikle önerilir (çoğu akışta pratik olarak gerekli hale gelir). Resmi referanslar:

• Pro Git: First-Time Git Setup
• GitHub Docs: Set up Git

Git kurulumunu doğrulayın

Terminalde:

• git --version
  Beklenen: Bir sürüm numarası görürsünüz.

Global kullanıcı adı ve e-posta ayarı

Commit’lerinizin kime ait olduğunu belirtmek için global ayarları yapın:

• git config --global user.name "Ad Soyad"
• git config --global user.email "[email protected]"

Kontrol etmek için:

• git config --global --list

Not: Buraya yazdığınız e-posta, GitHub hesabınızla aynı olmak zorunda değildir; ancak ekip/proje süreçlerine göre tercih değişebilir.

Varsayılan dal adını “main” yapmak (isteğe bağlı)

Birçok modern projede varsayılan dal adı olarak main tercih edilebilir. Bu davranış Git yapılandırmasıyla ayarlanabilir. Güncel yaklaşım ve ayrıntılar için resmi Git/GitHub dokümanlarına bakın: Pro Git ve GitHub Docs.

3) Node.js kurulumu (genellikle LTS tercih edilir)

Node.js, JavaScript’i bilgisayarınızda çalıştırmanızı ve npm ile paket yönetimi yapmanızı sağlar. Resmi indirme sayfası, LTS/Current ayrımını ve platforma göre kurulum seçeneklerini açıklar: Node.js Download (Official).

LTS mi Current mı?

Resmi Node.js indirme sayfasında genellikle LTS sürümünün üretim kullanımları için önerildiği belirtilir. Yeni başlayan biri olarak, özel bir ihtiyacınız yoksa LTS ile başlamak çoğu zaman daha sorunsuz bir yol olur. (Sürüm numaraları değişebildiği için, yayın tarihinde hangi sürümün LTS olduğunu sayfadan kontrol edin.)

Kurulum seçenekleri

• Doğrudan indirilebilir yükleyiciler: Windows/macOS için yaygın bir seçenek.
• Paket yöneticileri: Linux dağıtımına veya kullandığınız araca göre değişir; resmi sayfa ilgili yönergeleri listeler.

Doğrulama: node ve npm çalışıyor mu?

Kurulumdan sonra terminalde şunları çalıştırın:

• node -v
  Beklenen: Bir sürüm numarası yazdırılır.
• npm -v
  Beklenen: Bir sürüm numarası yazdırılır.

Bir sürüm değeri görüyorsanız, kurulum büyük olasılıkla tamamdır.

4) İlk mini proje: Node.js ile “Hello” çalıştırma

Şimdi her şeyin uçtan uca çalıştığını doğrulayalım. Aşağıdaki adımlar, herhangi bir framework kullanmadan basit bir Node projesi başlatır.

Proje klasörü oluşturun ve VS Code’da açın

1. Terminalde çalışma alanınızda bir klasör oluşturun: mkdir my-first-node
2. Klasöre girin: cd my-first-node
3. VS Code’da açın: code .

npm ile proje başlatın

VS Code içindeki Terminal’i açıp şunu çalıştırın:

• npm init -y

Bu komut, temel bir package.json dosyası üretir. (İsterseniz “-y” olmadan interaktif şekilde de doldurabilirsiniz.)

index.js oluşturun ve çalıştırın

1. Proje kök dizininde index.js adlı bir dosya oluşturun.
2. Dosyanın içine şunu yazın:

console.log("Hello from Node.js!");

Terminalde çalıştırın:

• node index.js

Beklenen: Terminalde “Hello from Node.js!” çıktısını görürsünüz.

5) Git ile projeyi sürüm kontrolüne alma

Bu adım, öğrenme sürecinde “geri dönüş noktaları” oluşturmak için idealdir.

Repo başlatın ve ilk commit’i atın

Proje klasörünüzde terminalde:

• git init
• git status
• git add .
• git commit -m "Initial commit"

Commit aşamasında isim/e-posta hatası alırsanız, bir önceki bölümdeki git config --global adımlarını kontrol edin (resmi referans: Pro Git).

6) GitHub’a gönderme: HTTPS mi SSH mı?

Projelerinizi GitHub’da saklamak; farklı cihazlardan çalışmak, portföy oluşturmak ve ileride işbirliği yapmak için faydalıdır. GitHub, uzak repoya erişim için genellikle HTTPS veya SSH seçeneklerini sunar. Bu seçim; şirket politikaları, çoklu hesap kullanımı ve güvenlik tercihlerine göre değişebilir.

GitHub’ın resmi anlatımı ve kurulum adımları için: GitHub Docs: Set up Git.

Seçeneklerin kısa karşılaştırması

• HTTPS: Kurulumu basittir. Bazı senaryolarda kimlik doğrulama için token kullanmanız gerekebilir (GitHub yönergelerine göre).
• SSH: Sık push/pull yapanlar için pratik olabilir. SSH anahtarı üretme ve anahtarı hesabınıza ekleme adımları gerekir; ayrıca yerelde ssh-agent kullanımı söz konusu olabilir.

Uzak repo ekleme (genel akış)

GitHub’da bir repo oluşturduktan sonra, size verilen repo adresini (HTTPS veya SSH) kullanarak ekleyebilirsiniz:

• git remote add origin REPO_URL
• git remote -v
• git push -u origin main (dal adınız farklıysa onu kullanın)

Not: Dal adınız main değilse (ör. master), push komutunda mevcut dal adınızı kullanın. Dal adlandırma ve varsayılan ayarlar hakkında yaklaşım farklılıkları olabileceği için resmi kaynakları referans almak en doğrusudur.

7) VS Code’da başlangıç için faydalı ayarlar ve alışkanlıklar

Kurulumdan sonra veriminizi artıracak birkaç pratik alışkanlık:

• Dahili Terminal: Komutları ayrı bir pencere yerine editör içinde çalıştırarak bağlam kaybını azaltın.
• Kaydetmeden önce format: JavaScript yazarken tutarlılık sağlar. (Takım içinde format tercihleri değişebilir.)
• Eklentiler: Başlangıçta az eklentiyle başlayıp ihtiyaca göre eklemek daha yönetilebilir olur.

VS Code’un kurulum ve komut satırı (CLI) detayları için resmi belgeyi takip edebilirsiniz: Visual Studio Code Setup Docs.

Yaygın sorunlar ve hızlı çözümler

“code” komutu çalışmıyor

• VS Code’un komut satırı aracının etkin olduğundan emin olun (özellikle macOS’te bu adım ayrı olabilir).
• PATH/CLI adımları için resmi kurulum dokümanını kontrol edin: VS Code Setup (kendi işletim sistemi sayfanıza geçin).

“git” komutu bulunamadı

• Git’in kurulu olduğunu doğrulamak için git --version deneyin (sürüm numarası görmelisiniz).
• En güvenilir yönlendirme resmi kaynaklardır: Pro Git.

“node” veya “npm” bulunamadı

• Node.js’i resmi indirme seçenekleriyle kurun ve kurulumdan sonra yeni bir terminal oturumu açıp tekrar deneyin.
• LTS/Current seçeneklerini ve platform yönergelerini resmi sayfadan kontrol edin: Node.js Download.

GitHub’a push sırasında kimlik doğrulama problemi

• HTTPS/SSH yönteminizin doğru seçildiğini ve hesabınızla eşleştiğini kontrol edin.
• SSH/HTTPS kurulum adımları için GitHub dokümanına gidin: GitHub: Set up Git.

5 dakikalık özet: En kısa “hızlı başlangıç” akışı

1. VS Code’u kur → Terminalde code --version (sürüm numarası gör)
2. Git’i kur → git --version → commit için git config --global user.name / user.email
3. Node.js (LTS) kur → node -v ve npm -v (sürüm numarası gör)
4. İlk proje → npm init -y → node index.js
5. Git commit → git init → git add . → git commit

Sonraki adım: Öğrenmeyi sürdürülebilir hale getirin

Geliştirme ortamınız hazırsa, artık “kodlama öğren” hedefinde önemli bir eşiği geçtiniz: çalışır bir kurulum. Bundan sonra küçük, düzenli alıştırmalarla ilerlemek daha verimli olur. Örneğin:

• Her gün 20–30 dakika JavaScript temelleri (değişkenler, fonksiyonlar, diziler)
• Her mini alıştırmayı Git ile commit etmek
• Haftada bir kez küçük bir Node.js komut satırı alıştırması denemek

Kurulum adımlarını paylaşmak veya ekip içinde standartlaştırmak isterseniz, bu sayfadaki kontrol listesini kopyalayıp proje dokümantasyonunuza ekleyebilirsiniz.