Visual Studio Code (VS Code) Komut Satırı Arayüzü (CLI) Kurulumu ve Kullanımı
Visual Studio Code (VS Code), modern yazılım geliştiricilerinin vazgeçilmez araçlarından biri haline gelmiştir. Hafif yapısı, genişletilebilirliği, zengin özellik setleri ve çoklu platform desteği sayesinde milyonlarca geliştirici tarafından tercih edilmektedir. VS Code’un sunduğu görsel arayüz, kod yazmayı, hata ayıklamayı ve proje yönetimini kolaylaştırırken, bu güçlü editörün bir de komut satırı arayüzü (CLI) bulunmaktadır. VS Code CLI, geliştiricilere terminal üzerinden VS Code’un birçok özelliğine erişme imkanı sunarak iş akışlarını daha verimli hale getirmelerine olanak tanır.
Bu makalede, VS Code CLI’ın ne olduğunu, nasıl kurulduğunu ve çeşitli kullanım senaryolarıyla birlikte nasıl etkin bir şekilde kullanılabileceğini detaylı bir şekilde inceleyeceğiz. İster deneyimli bir geliştirici olun ister VS Code’a yeni başlayan biri, CLI’ın sunduğu imkanlar sayesinde geliştirme sürecinizi hızlandırabilir, otomatikleştirebilir ve daha esnek bir çalışma ortamı oluşturabilirsiniz. Özellikle sunucu ortamlarında, otomasyon scriptlerinde veya klavye odaklı çalışan geliştiriciler için VS Code CLI, paha biçilmez bir araçtır.
VS Code CLI Nedir?
VS Code CLI, code komutu aracılığıyla terminalinizden Visual Studio Code’u kontrol etmenizi sağlayan bir dizi araç ve fonksiyondur. Bu komut, VS Code uygulamasının kendisiyle birlikte gelir ve doğru şekilde yapılandırıldığında sistem PATH’inize eklenir. code komutu sayesinde, bir dosya veya klasörü doğrudan terminalden açabilir, uzantıları yönetebilir, ayarları değiştirebilir, dosyalar arasındaki farkları görebilir ve hatta VS Code’u uzaktan veya bir web tarayıcısı üzerinden çalıştırabilirsiniz.
CLI’ın sunduğu başlıca avantajlar şunlardır:
* Hız ve Verimlilik: Fareye dokunmadan klavye üzerinden hızlıca dosya ve klasörleri açabilir, uzantıları yönetebilirsiniz.
* Otomasyon: Scriptler ve otomasyon araçları ile VS Code’u entegre edebilirsiniz. Örneğin, bir Git pre-commit hook’unda belirli bir linter’ı çalıştırmak veya bir proje oluşturma script’inde gerekli uzantıları otomatik olarak yüklemek mümkündür.
* Uzaktan Çalışma: SSH, Dev Containers veya WSL gibi uzaktan geliştirme senaryolarında VS Code’u sunucu tarafında çalıştırabilir ve yerel makinenizdeki VS Code ile bağlantı kurabilirsiniz.
* Sunucu Ortamları: Grafik arayüzü olmayan sunucu ortamlarında bile VS Code Server aracılığıyla web tabanlı bir VS Code deneyimi sunar.
* Esneklik: Farklı çalışma alanları, profiller ve ayarlar arasında hızlıca geçiş yapma imkanı sağlar.
VS Code CLI Kurulumu
VS Code CLI’ı kullanabilmek için öncelikle VS Code uygulamasının kendisinin yüklü olması ve code komutunun sistem PATH’inize eklenmiş olması gerekir. Kurulum süreci işletim sistemine göre küçük farklılıklar gösterir.
Windows
Windows’ta VS Code kurarken, kurulum sihirbazında “Add to PATH” (PATH’e ekle) seçeneğini işaretlemek genellikle yeterlidir. Bu seçenek, code komutunu otomatik olarak sistem PATH değişkeninize ekler, böylece Komut İstemi (CMD) veya PowerShell’den doğrudan çağırabilirsiniz.
Eğer bu seçeneği kaçırdıysanız veya sonradan eklemek isterseniz, iki farklı yöntem kullanabilirsiniz:
1. VS Code İçinden Ekleme:
* VS Code’u açın.
* Ctrl+Shift+P tuş kombinasyonu ile Komut Paleti’ni açın.
* shell command yazın ve Shell Command: Install 'code' command in PATH seçeneğini aratıp tıklayın.
* Bu işlem, VS Code’un yükleme dizinindeki bin klasörünü PATH’inize ekleyecektir.
* Değişikliğin etkili olması için mevcut Komut İstemi veya PowerShell pencerelerini kapatıp yeniden açmanız gerekebilir.
2. Manuel PATH Ekleme:
* VS Code’un kurulu olduğu dizini bulun (genellikle C:\Users\\AppData\Local\Programs\Microsoft VS Code veya C:\Program Files\Microsoft VS Code).
* Bu dizinin içindeki bin klasörünün yolunu kopyalayın (örneğin, C:\Program Files\Microsoft VS Code\bin).
* “Başlat” menüsünden “Ortam Değişkenleri” yazarak “Sistem ortam değişkenlerini düzenleyin” seçeneğini açın.
* “Ortam Değişkenleri” düğmesine tıklayın.
* “Sistem değişkenleri” bölümünde Path değişkenini bulun ve “Düzenle” düğmesine tıklayın.
* “Yeni” düğmesine tıklayarak kopyaladığınız bin klasörünün yolunu ekleyin ve tüm pencereleri “Tamam” diyerek kapatın.
* Değişikliğin etkili olması için Komut İstemi veya PowerShell’i yeniden başlatın.
Kurulumu test etmek için:
code --version
Bu komut, VS Code sürüm numarasını göstermelidir.
macOS
macOS’ta VS Code CLI’ı kurmak oldukça kolaydır ve genellikle VS Code içinden yapılır:
1. VS Code İçinden Ekleme:
* VS Code’u açın.
* Cmd+Shift+P tuş kombinasyonu ile Komut Paleti’ni açın.
* shell command yazın ve Shell Command: Install 'code' command in PATH seçeneğini aratıp tıklayın.
* Bu işlem, /usr/local/bin dizinine code adlı bir sembolik bağlantı (symlink) oluşturur ve bu dizin genellikle zaten sistem PATH’inize ekli olduğu için code komutu terminalden erişilebilir hale gelir.
* Değişikliğin etkili olması için mevcut Terminal pencerelerini kapatıp yeniden açmanız gerekebilir.
Manuel olarak PATH’e eklemeniz gerekirse (nadiren):
* ~/.zshrc (macOS Catalina ve sonrası için varsayılan) veya ~/.bash_profile dosyanızı açın.
* Aşağıdaki satırı ekleyin:
export PATH="/Applications/Visual Studio Code.app/Contents/Resources/app/bin:$PATH"
* Dosyayı kaydedin ve terminalinizi yeniden başlatın veya source ~/.zshrc (veya source ~/.bash_profile) komutunu çalıştırın.
Kurulumu test etmek için:
code --version
Bu komut, VS Code sürüm numarasını göstermelidir.
Linux
Linux’ta VS Code CLI kurulumu, kullandığınız dağıtıma ve VS Code’u nasıl kurduğunuza bağlı olarak değişebilir.
1. VS Code İçinden Ekleme (Önerilen Yöntem):
* VS Code’u açın.
* Ctrl+Shift+P tuş kombinasyonu ile Komut Paleti’ni açın.
* shell command yazın ve Shell Command: Install 'code' command in PATH seçeneğini aratıp tıklayın.
* Bu işlem genellikle /usr/local/bin dizinine bir sembolik bağlantı oluşturur ve bu dizin çoğu Linux dağıtımında varsayılan olarak PATH’e eklenmiştir.
* Değişikliğin etkili olması için mevcut Terminal pencerelerini kapatıp yeniden açmanız gerekebilir.
2. Paket Yöneticileri ile Kurulum:
* Eğer VS Code’u bir paket yöneticisi (APT, DNF, Pacman, Snap vb.) kullanarak kurduysanız, code komutu genellikle otomatik olarak PATH’inize eklenir.
* Debian/Ubuntu (APT): sudo apt install code
* Fedora (DNF): sudo dnf install code
* Arch Linux (Pacman): sudo pacman -S code (AUR’dan)
* Snap: sudo snap install --classic code
* Bu yöntemlerde code komutu genellikle kurulumla birlikte gelir ve hemen kullanılabilir.
3. Manuel Kurulum ve PATH Ekleme:
* Eğer VS Code’u .deb, .rpm paketi indirerek veya .tar.gz arşivinden manuel olarak kurduysanız, code komutunu PATH’e kendiniz eklemeniz gerekebilir.
* VS Code’un çalıştırılabilir dosyasının bulunduğu dizini bulun (örneğin, ~/VSCode-linux-x64/bin).
* ~/.bashrc, ~/.zshrc veya ~/.profile dosyanızı açın.
* Aşağıdaki satırı ekleyin (yolu kendi VS Code kurulum yolunuza göre ayarlayın):
export PATH="$PATH:/path/to/VSCode/bin"
* Dosyayı kaydedin ve terminalinizi yeniden başlatın veya source ~/.bashrc (veya kullandığınız kabuk yapılandırma dosyası) komutunu çalıştırın.
* Alternatif olarak, VS Code’un çalıştırılabilir dosyasını /usr/local/bin gibi PATH’e ekli bir dizine sembolik olarak bağlayabilirsiniz:
sudo ln -s /path/to/VSCode/code /usr/local/bin/code
Kurulumu test etmek için:
code --version
Bu komut, VS Code sürüm numarasını göstermelidir.
Temel VS Code CLI Komutları ve Kullanımı
code komutunun temel sözdizimi genellikle code [seçenekler] [argümanlar] şeklindedir. İşte en sık kullanılan komutlar ve senaryolar:
Dosya ve Klasör Açma
Bu, CLI’ın en temel ve en sık kullanılan işlevidir.
* Mevcut Klasörü Açma:
code .
Bu komut, terminalin o anki çalışma dizinini yeni bir VS Code penceresinde açar.
* Belirli Bir Klasörü Açma:
code /path/to/your/project
Belirtilen klasörü VS Code’da açar.
* Belirli Bir Dosyayı Açma:
code my_file.js
my_file.js dosyasını VS Code’da açar. Eğer dosya mevcut değilse, yeni bir boş dosya oluşturur.
* Birden Fazla Dosya veya Klasör Açma:
code file1.js folder1 file2.ts
Birden fazla öğeyi aynı anda açar.
* Belirli Bir Satır ve Sütuna Gitme:
Hata mesajlarındaki konumları hızlıca açmak için idealdir.
code -g my_file.js:10:5
my_file.js dosyasını açar ve imleci 10. satırın 5. sütununa konumlandırır. -g veya --goto kısaltması kullanılır.
* Mevcut Pencerede Açma:
Varsayılan olarak, code komutu yeni bir pencere açar. Mevcut bir VS Code penceresinde açmak için:
code -r my_file.js
# veya
code --reuse-window my_file.js
* Yeni Bir Pencerede Açma:
Açık bir VS Code penceresi olsa bile yeni bir pencere açmak için:
code -n my_file.js
# veya
code --new-window my_file.js
* Yeni Bir Boş Pencere Açma:
code --empty-window
Hiçbir dosya veya klasör açmadan boş bir VS Code penceresi başlatır.
Uzantı Yönetimi
VS Code CLI, uzantıları yüklemek, kaldırmak ve listelemek için de kullanılabilir. Bu, özellikle yeni bir geliştirme ortamı kurarken veya otomasyon scriptlerinde faydalıdır.
* Uzantı Yükleme:
Uzantının tam kimliğini bilmeniz gerekir (genellikle yayıncı.uzantıadı formatında).
code --install-extension esbenp.prettier-vscode
* Uzantı Kaldırma:
code --uninstall-extension esbenp.prettier-vscode
* Yüklü Uzantıları Listeleme:
code --list-extensions
Bu komut, yüklü tüm uzantıların kimliklerini listeler.
* Önerilen API’yi Etkinleştirme (Geliştiriciler İçin):
code --enable-proposed-api
Bu, bir uzantının henüz genel kullanıma sunulmamış API’lerini test etmek için kullanılır.
Ayarlar ve Yapılandırma
CLI, VS Code’un bazı yapılandırma özelliklerine de erişim sağlar.
* Dosyalar Arasındaki Farkları Karşılaştırma (Diff):
İki dosya arasındaki farkları VS Code’un dahili diff aracında görmek için:
code --diff file1.txt file2.txt
Bu, Git commit’lerinden veya farklı versiyonlardan gelen değişiklikleri incelemek için çok kullanışlıdır.
* URI ile Açma:
VS Code, dosyaları ve klasörleri URI (Uniform Resource Identifier) kullanarak da açabilir. Bu, bazı özel entegrasyonlar veya uzaktan geliştirme senaryoları için kullanışlıdır.
code --folder-uri "vscode-remote://ssh-remote+your_server/home/user/project"
code --file-uri "vscode-remote://ssh-remote+your_server/home/user/project/index.js"
* Profiller ile Çalışma:
VS Code, farklı programlama dilleri veya projeler için farklı uzantı ve ayar setleri içeren profiller oluşturmanıza olanak tanır. CLI, bu profilleri yönetmenize yardımcı olur.
* Belirli Bir Profille Açma:
code --profile "Web Development" .
Mevcut klasörü “Web Development” profiliyle açar.
* Mevcut Çalışma Alanını Bir Profile Ekleme:
code --add-to-profile "My New Profile"
Açık olan çalışma alanını belirtilen profile ekler.
* Profili Dışa Aktarma:
code --export-profile "My New Profile" --target my-new-profile.json
Belirtilen profili bir JSON dosyasına dışa aktarır.
* Profili İçe Aktarma:
code --import-profile my-new-profile.json
Bir JSON dosyasından profil içe aktarır.
Gelişmiş Kullanım Senaryoları
VS Code CLI, uzaktan geliştirme ve sunucu ortamları gibi daha karmaşık senaryolarda da kilit bir rol oynar.
* SSH Üzerinden Uzaktan Geliştirme:
VS Code’un Remote – SSH uzantısı ile birlikte CLI, uzak sunucularda kod geliştirmenize olanak tanır. Yerel makinenizden bir SSH bağlantısı üzerinden uzak sunucudaki dosyaları düzenleyebilir, terminali kullanabilir ve hata ayıklama yapabilirsiniz.
* Önce Remote – SSH uzantısını yükleyin.
* Uzak sunucuya bağlanmak için:
code --remote ssh-remote+your_username@your_server_ip /path/to/project
Bu komut, belirtilen SSH sunucusuna bağlanır ve uzak sunucudaki projeyi açar. VS Code, uzak sunucuda otomatik olarak bir VS Code Server örneği başlatır ve yerel VS Code istemcinizle iletişim kurar.
* Dev Containers ile Çalışma:
Dev Containers uzantısı, geliştirme ortamınızı bir Docker konteyneri içinde izole etmenizi sağlar. CLI, bu konteynerlere bağlanmak için kullanılabilir.
code --folder-uri vscode-remote://dev-container+/path/in/container
Bu, belirli bir geliştirme konteyneri içindeki bir klasörü açar.
* WSL (Windows Subsystem for Linux) Entegrasyonu:
Windows kullanıcıları için WSL, Linux ortamını Windows içinde çalıştırma imkanı sunar. VS Code, WSL ile derinlemesine entegredir.
* WSL terminalinden doğrudan VS Code’u açabilirsiniz:
code .
Bu komut, WSL içindeki mevcut Linux çalışma dizinini Windows’taki VS Code’da açar. VS Code, WSL içinde bir VS Code Server başlatarak bu entegrasyonu sağlar.
* VS Code Server ve Web Tarayıcısı Üzerinden Kullanım:
VS Code Server, VS Code’un çekirdek geliştirme deneyimini uzaktan veya web tarayıcısı üzerinden erişilebilir hale getiren bir arka plan hizmetidir. Bu, bulut tabanlı geliştirme ortamları, düşük kaynaklı cihazlar veya tabletler için idealdir.
* VS Code Server’ı Başlatma:
code serve-web --host 0.0.0.0 --port 8080 --accept-server-license-terms
Bu komut, VS Code Server’ı belirtilen IP ve port üzerinde başlatır. Ardından, herhangi bir web tarayıcısından http://:8080 adresine giderek VS Code’a erişebilirsiniz. --accept-server-license-terms argümanı, lisans koşullarını kabul ettiğinizi belirtir.
* VS Code Tunnel ile Uzaktan Erişim:
code tunnel komutu, VS Code Server’ı bir tünel üzerinden internete açmanıza olanak tanır, böylece herhangi bir yerden, herhangi bir cihazdan tarayıcı üzerinden geliştirme ortamınıza erişebilirsiniz. Bu, statik IP adresi veya port yönlendirme gereksinimini ortadan kaldırır.
code tunnel
Bu komut, cihazınızda bir VS Code tüneli başlatır ve size bir URL verir. Bu URL üzerinden VS Code hesabınızla oturum açarak tarayıcı üzerinden geliştirme ortamınıza erişebilirsiniz.
Diğer Faydalı Komutlar
* Çalışan VS Code Örneklerinin Durumunu Görme:
code --status
Bu komut, çalışan VS Code pencerelerinin PID’lerini, açtıkları klasörleri ve diğer bilgileri gösterir.
* VS Code Kapatılana Kadar Bekleme:
Scriptlerde veya commit hook’larında, VS Code’un bir dosyayı düzenlemeyi bitirmesini beklemek için kullanılır.
code --wait my_file.js
Bu komut, my_file.js dosyasını açar ve siz VS Code penceresini kapatana kadar terminalde bekler.
* Tüm Uzantıları Devre Dışı Bırakarak Açma:
Bir uzantının sorunlara neden olup olmadığını test etmek için kullanışlıdır.
code --disable-extensions .
* Belirli Uzantıları Devre Dışı Bırakarak Açma:
code --disable-extension .
* Detaylı Log Çıktısı Alma:
Sorun giderme için daha fazla bilgiye ihtiyaç duyulduğunda kullanılır.
code --verbose
* Tüm Komutları ve Seçenekleri Listeleme:
code --help
Bu komut, code komutunun tüm kullanılabilir seçeneklerini ve açıklamalarını gösterir.
CLI Kullanımında İpuçları ve En İyi Uygulamalar
VS Code CLI’ı iş akışınıza entegre etmek için bazı ipuçları:
* Alias’lar Oluşturma: Sık kullandığınız uzun komutlar için kısa alias’lar oluşturun. Örneğin, code . yerine sadece c . yazmak için kabuk yapılandırma dosyanıza (örneğin ~/.bashrc veya ~/.zshrc) şunu ekleyebilirsiniz:
alias c='code'
Ardından source komutuyla veya terminali yeniden başlatarak alias’ı etkinleştirin.
* Script’lerde ve Otomasyonda Kullanma: CLI’ın gücü, onu otomasyon script’lerinde kullanabilmenizdir. Örneğin, yeni bir proje oluşturma script’inde gerekli uzantıları otomatik olarak yükleyebilirsiniz:
#!/bin/bash
# Yeni bir Node.js projesi oluştur
mkdir my-nodejs-app && cd my-nodejs-app
npm init -y
# VS Code'da aç ve gerekli uzantıları yükle
code . --wait
code --install-extension dbaeumer.vscode-eslint
code --install-extension esbenp.prettier-vscode
echo "Proje hazır ve VS Code açık!"
* Git Hook’ları ile Entegrasyon: pre-commit hook’ları gibi Git hook’ları içinde CLI komutlarını kullanarak kod kalitesi kontrolleri yapabilirsiniz. Örneğin, commit etmeden önce belirli bir linter’ı çalıştırmak:
#!/bin/sh
# .git/hooks/pre-commit dosyasına ekleyin
code --wait --diff $(git diff --name-only --cached)
# Veya bir linter çalıştırmak için
# npx eslint --fix . && git add .
* Dotfiles Yönetimi: settings.json, keybindings.json gibi VS Code yapılandırma dosyalarınızı dotfiles olarak yönetiyorsanız, CLI ile bu dosyalara hızlıca erişebilir veya senkronize edebilirsiniz.
* Klavye Kısayolları ile CLI Komutlarını Tetikleme: Bazı terminal emülatörleri veya işletim sistemi kısayol araçları, belirli CLI komutlarını klavye kısayollarına atamanıza olanak tanır. Bu sayede, örneğin Ctrl+Alt+V tuşlarına basarak mevcut çalışma dizinini VS Code’da açabilirsiniz.
Sıkça Karşılaşılan Sorunlar ve Çözümleri
VS Code CLI kullanırken karşılaşılabilecek bazı yaygın sorunlar ve çözümleri:
* 'code' is not recognized as an internal or external command (Windows) veya command not found: code (macOS/Linux):
* Sorun: Bu hata, code komutunun sistem PATH’inize ekli olmadığı anlamına gelir.
* Çözüm: Yukarıdaki “VS Code CLI Kurulumu” bölümündeki adımları takip ederek code komutunu PATH’inize ekleyin. Özellikle VS Code içinden “Shell Command: Install ‘code’ command in PATH” komutunu çalıştırmayı deneyin ve terminalinizi yeniden başlattığınızdan emin olun.
* Uzantı Yükleme Hataları:
* Sorun: Uzantı kimliği yanlış olabilir veya internet bağlantısı olmayabilir.
* Çözüm: code --list-extensions komutuyla yüklü uzantıların doğru kimliklerini kontrol edin. Uzantı kimliklerini VS Code Marketplace sayfasından da bulabilirsiniz. İnternet bağlantınızı kontrol edin.
* Uzaktan Bağlantı Sorunları (SSH, Dev Containers):
* Sorun: Bağlantı kurulamıyor, kimlik doğrulama hataları veya sunucu tarafında VS Code Server başlamıyor.
* Çözüm: SSH bağlantılarınızın düzgün çalıştığından emin olun (örneğin, ssh user@host ile bağlanmayı deneyin). Remote – SSH uzantısının yüklü olduğundan emin olun. Uzak sunucuda yeterli disk alanı ve bellek olduğundan emin olun. Logları (code --verbose ile) kontrol edin.
* Performans Sorunları:
* Sorun: VS Code CLI komutları yavaş çalışıyor veya VS Code açılırken gecikmeler yaşanıyor.
* Çözüm: Çok fazla uzantı yüklüyse, --disable-extensions ile test edin. VS Code’un önbelleğini temizlemeyi deneyin. Sistem kaynaklarınızın (RAM, CPU) yeterli olduğundan emin olun. Özellikle uzaktan çalışırken ağ bağlantı hızınızın yeterli olduğundan emin olun.
Sonuç
Visual Studio Code Komut Satırı Arayüzü (CLI), geliştiricilerin günlük iş akışlarını önemli ölçüde hızlandırabilecek ve otomatikleştirebilecek güçlü bir araçtır. Dosya ve klasörleri hızlıca açmaktan, uzantıları yönetmeye, dosyalar arasındaki farkları karşılaştırmaya ve hatta uzaktan geliştirme ortamlarını yapılandırmaya kadar geniş bir yelpazede işlevsellik sunar.
CLI’ın kurulumu, işletim sisteminize bağlı olarak birkaç basit adımla tamamlanabilir ve ardından code komutu ile terminalinizden VS Code’un gücünü parmaklarınızın ucuna getirirsiniz. Özellikle otomasyon scriptleri, Git hook’ları veya sunucu tabanlı geliştirme senaryolarında CLI, paha biçilmez bir yardımcıdır.
Bu makalede ele alınan komutlar ve kullanım senaryoları, VS Code CLI’ın sunduğu imkanların sadece bir başlangıcıdır. Her geliştiricinin kendi ihtiyaçlarına göre bu aracı keşfetmesi ve iş akışına entegre etmesi, verimliliği artırmanın anahtarıdır. code --help komutunu kullanarak daha fazla seçeneği keşfetmekten çekinmeyin ve CLI’ı geliştirme sürecinizin ayrılmaz bir parçası haline getirin.
