VS Code'da Modern Python Geliştirme: Sıfırdan Production-Grade IDE Setup

Kurulum#

macOS#

# Homebrew
brew install --cask visual-studio-code

# Veya direkt indirip .app sürükle
# https://code.visualstudio.com/download

Windows#

# Winget (önerilen)
winget install -e --id Microsoft.VisualStudioCode

Linux#

# Ubuntu/Debian
sudo apt install software-properties-common apt-transport-https wget
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install code

# Fedora
sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
sudo sh -c 'echo -e "[code]\nname=Visual Studio Code\nbaseurl=https://packages.microsoft.com/yumrepos/vscode\nenabled=1\ngpgcheck=1\ngpgkey=https://packages.microsoft.com/keys/microsoft.asc" > /etc/yum.repos.d/vscode.repo'
sudo dnf install code

İlk açılış#

# Komut satırından bir klasör aç
code .                  # mevcut klasör
code ~/projects/myapp   # belirli klasör
code file.py            # tek dosya

Olmazsa olmaz extension'lar#

Önerilenler (kalite hayatı)#

Kurulum (komut satırından)#

code --install-extension ms-python.python
code --install-extension ms-python.vscode-pylance
code --install-extension ms-toolsai.jupyter
code --install-extension charliermarsh.ruff
code --install-extension tamasfe.even-better-toml
code --install-extension usernamehw.errorlens
code --install-extension eamodio.gitlens
code --install-extension streetsidesoftware.code-spell-checker
code --install-extension christian-kohler.path-intellisense
code --install-extension njpwerner.autodocstring

Python interpreter seçimi — VS Code'un en kritik adımı#

Cmd/Ctrl + Shift + P → "Python: Select Interpreter"

Python 3.13.0 ('myproject': venv)         /Users/me/myproject/venv/bin/python
Python 3.13.0                              /Users/me/.pyenv/versions/3.13.0/bin/python
Python 3.12.7                              /Users/me/.pyenv/versions/3.12.7/bin/python
Python 3.10.13                             /Users/me/.pyenv/versions/3.10.13/bin/python
Python 3.9.6                               /usr/bin/python3 (system)

• pyenv kurulumları
• Klasördeki
  venv/
  ve
  .venv/
  virtualenv'leri
• conda environment'ları
• System Python

• VS Code alt status bar'da seçili Python sürümünü gösterir.
• Tüm IntelliSense, debugger, terminal aktiviteleri o Python'a göre çalışır.
• Yeni terminal açtığında otomatik virtualenv aktif olur.

Workspace ayarı kalıcı yap#

// .vscode/settings.json
{
  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python"
}

settings.json — VS Code'u yontmak#

• User settings (
  ~/.config/Code/User/settings.json
  ): Tüm projelerde geçerli, kişisel.
• Workspace settings (
  .vscode/settings.json
  ): Sadece bu klasörde, takımla paylaşılan.

Önerilen Python ayarları (workspace settings)#

{
  "// Python core": "",
  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
  "python.terminal.activateEnvironment": true,
  "python.analysis.typeCheckingMode": "basic",
  "python.analysis.autoImportCompletions": true,
  "python.analysis.diagnosticMode": "openFilesOnly",

  "// Linting & formatting (ruff)": "",
  "[python]": {
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
      "source.fixAll.ruff": "explicit",
      "source.organizeImports.ruff": "explicit"
    }
  },

  "// Test (pytest)": "",
  "python.testing.pytestEnabled": true,
  "python.testing.unittestEnabled": false,
  "python.testing.pytestArgs": ["tests"],

  "// Editor genel": "",
  "editor.rulers": [88, 100],
  "editor.formatOnSave": true,
  "editor.tabSize": 4,
  "editor.insertSpaces": true,
  "files.insertFinalNewline": true,
  "files.trimTrailingWhitespace": true,

  "// Excludes": "",
  "files.exclude": {
    "**/__pycache__": true,
    "**/.pytest_cache": true,
    "**/.ruff_cache": true,
    "**/*.pyc": true
  }
}

• Ruff otomatik formatlar (black-uyumlu).
• Import'lar otomatik sıralanır.
• Trailing whitespace temizlenir.
• Final newline eklenir.

.vscode/extensions.json ile takım extension önerisi#

{
  "recommendations": [
    "ms-python.python",
    "ms-python.vscode-pylance",
    "ms-toolsai.jupyter",
    "charliermarsh.ruff",
    "tamasfe.even-better-toml"
  ]
}

Debugger — IDE'nin gerçek değeri#

Hızlı debug#

Breakpoint koyma#

• Satır numarası soluna tıkla → kırmızı nokta (breakpoint).
• F9 ile shortcut.

Variables, Watch, Call Stack#

• Variables: Mevcut scope'taki değişkenler — fareyi nesnenin üzerine getir, içeriğini gör.
• Watch: Manuel "şu değişkene gözüm olsun" listesi.
• Call Stack: Şu an hangi fonksiyondasın, nereden çağrıldı.
• Breakpoints: Tüm breakpoint'lerin listesi.
• Debug Console: Debug çalışırken Python ifadesi yaz, çalıştır.

launch.json — gelişmiş debug konfigürasyonu#

// .vscode/launch.json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Python: Current File",
      "type": "debugpy",
      "request": "launch",
      "program": "${file}",
      "console": "integratedTerminal",
      "justMyCode": true
    },
    {
      "name": "Python: Module",
      "type": "debugpy",
      "request": "launch",
      "module": "myapp.main",
      "args": ["--verbose", "--config", "dev.toml"],
      "env": {
        "DEBUG": "1",
        "DATABASE_URL": "sqlite:///dev.db"
      },
      "console": "integratedTerminal"
    },
    {
      "name": "FastAPI: dev server",
      "type": "debugpy",
      "request": "launch",
      "module": "uvicorn",
      "args": ["myapp.main:app", "--reload", "--port", "8000"],
      "jinja": true,
      "console": "integratedTerminal"
    },
    {
      "name": "Python: Pytest current file",
      "type": "debugpy",
      "request": "launch",
      "module": "pytest",
      "args": ["${file}", "-v"],
      "console": "integratedTerminal"
    },
    {
      "name": "Python: Attach to running process",
      "type": "debugpy",
      "request": "attach",
      "connect": {"host": "localhost", "port": 5678}
    }
  ]
}

Jupyter Notebook desteği#

File → New File → ".ipynb"

• Cell'ler arası geçiş (J/K vim-like, veya ↑/↓)
• Run cell (Shift+Enter)
• Markdown rendering
• Plot inline
• Variable explorer (sol panelde)

Kernel seçimi#

Interactive Window — notebook olmadan notebook deneyimi#

# %%
import pandas as pd
df = pd.read_csv("data.csv")
df.head()

# %%
df.groupby("region").sum()

# %%
import matplotlib.pyplot as plt
df["amount"].plot(kind="hist")
plt.show()

Tasks ile özel komutlar#

// .vscode/tasks.json
{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "Run tests",
      "type": "shell",
      "command": "${workspaceFolder}/.venv/bin/pytest",
      "args": ["-v", "tests/"],
      "group": {
        "kind": "test",
        "isDefault": true
      },
      "presentation": {
        "reveal": "always",
        "panel": "new"
      }
    },
    {
      "label": "Format with ruff",
      "type": "shell",
      "command": "ruff",
      "args": ["format", "src/", "tests/"]
    },
    {
      "label": "Type check with mypy",
      "type": "shell",
      "command": "mypy",
      "args": ["src/"]
    },
    {
      "label": "Start dev server",
      "type": "shell",
      "command": "uvicorn",
      "args": ["myapp.main:app", "--reload"],
      "isBackground": true
    }
  ]
}

Remote development — uzak ortamlarda yerel deneyim#

1. Remote - SSH#

# SSH config'in olduğunu varsayıyorum (~/.ssh/config)
Host myserver
  HostName 192.168.1.100
  User ubuntu
  IdentityFile ~/.ssh/id_ed25519

2. Remote - WSL (Windows kullanıcılar için)#

wsl   # WSL terminal'inde
code .  # mevcut klasörü VS Code'la WSL bağlantılı aç

3. Remote - Containers (Dev Containers)#

{
  "name": "Python 3.13 dev",
  "image": "mcr.microsoft.com/devcontainers/python:3.13",
  "features": {
    "ghcr.io/devcontainers/features/git:1": {}
  },
  "customizations": {
    "vscode": {
      "extensions": [
        "ms-python.python",
        "ms-python.vscode-pylance",
        "charliermarsh.ruff"
      ],
      "settings": {
        "python.defaultInterpreterPath": "/usr/local/bin/python"
      }
    }
  },
  "postCreateCommand": "pip install -r requirements.txt"
}

4. GitHub Codespaces#

Hayatını değiştirecek 20 klavye kısayolu#

Bu derste neler kazandın?#