====== Python & VSCode Setup ======

==== Setup VSCode & Python ====

   1. Editor **Visual Studio Code (VSCode)** herunterladen und installieren: [[https://code.visualstudio.com]] \\ \\
   1. Lade die **aktuelle Version von Python herunter**: [[https://www.python.org/downloads/]] (Stand Feb. 2025: Python 3.13)\\ **Wichtig:** Wähle "Add python.exe to PATH" und/oder "Add Python to environment variables." aus! \\ \\
   {{:gf_informatik:python_vscode_setup:pasted:20250224-193631.png?nolink&400}}
   1. In VSCode installiere die folgenden **Erweiterungen / Extensions**, die dir das Programmieren mit Python erleichtern: "Anzeigen" / "Erweiterungen" oder Tab auf linken Seite:
      1. [[https://marketplace.visualstudio.com/items?itemName=ms-python.python|Python]] (von Microsoft) \\ \\
   1. In VSCode den **Ordner öffnen**, in dem man arbeiten möchte: "Datei" / "Ordner öffnen"\\ \\
   1. Direkt in VScode ein neue Datei mit der Python-Endung `.py` erstellen, z.B. `hello_world.py`. Dazu muss der "Explorer"-Tab geöffnet sein: Oben links auf entsprechendes Symbol klicken oder "Anzeigen" / "Explorer".\\ \\
   1. Diese Python-Datei öffnen und ausführen: "F5" oder "Ausführen" / "Debugging Starten"


==== Python programmieren in VSCode ====

   1. Dateien öffnet man am besten *nicht* per Doppelklick, sondern startet VSCode und **öffnet den Ordner**, in dem man arbeiten möchte: "Datei" / "Ordner öffnen" / Ordner auswählen.
      1. Sicher stellen, dass **"Explorer"-Tab** geöffnet ist: Oben links auf entsprechendes Symbol klicken oder "Anzeigen" / "Explorer".
      1. Vorteil: jetzt sieht alle Dateien und Unterordner und kann direkt dort neue Dateien erstellen, löschen, umbenennen, Unterordner erstellen usw. Man kann also alles direkt im VSCode erledigen und muss nicht in den Windows Explorer des Computers wechseln.\\ \\
   1. Bestehende Python-Datei **öffnen** oder **neue erstellen** (Wichtig: Muss Endung `.py` oder `.ipynb`, mehr dazu unten, haben) und darin programmieren.\\ \\
   1. **Programm ausführen:** "F5" drücken.
      1. Beim **ersten Ausführen** erscheint die Meldung "Debugger auswählen": "Python Debugger" / "Python Datei". Falls mehrere Versionen von Python installiert wurden, muss man eine davon auswählen.
      1. Falls die Meldung `'Zum Anpassen von "Ausführen und Debuggen" erstellen Sie eine launch.json-Datei'` erhalten, auf diese klicken, um eine launch.json Datei zu erstellen.\\ \\


==== Python Module installieren ====

Um Python-Module wie numpy usw. zu installieren, verwendet man **pip** (**p**ip **i**nstalls **p**ackages):

   1. VSCode öffnen, Projektordner öffnen\\ \\
   1. Im Menu <key>Terminal > Open new Terminal</key> auswählen \\ \\
   1. **Befehl für Installation** geben: `pip install <module-name>`, z.B. `pip install numpy`


==== Nützliche Links ====

   * **Keyboard Shortcuts VSCode**:
     * [[https://code.visualstudio.com/shortcuts/keyboard-shortcuts-windows.pdf|Windows]]
     * [[https://code.visualstudio.com/shortcuts/keyboard-shortcuts-macos.pdf|MacOS]]


==== Jupyter-Notebooks (optional) ====

   1. Anstelle von klassischen Python-Files (`.py`) kann man auch mit **Jupyter-Notebooks** arbeiten. Ein solches ist eine **Mischung aus Python-File und Textdokument** (im Markdown Format).
   1. Man erstellt ein **neues Jupyter-Notebook**, indem man ein File mit Endung `.ipynb` (für **i**nteravtive **py**thon **n**ote**b**ook) erstellt. Nun kann beliebig viele **Textblöcke** (Markdown) und **Codeblöcke** aneinander reihen.
   1. Die wichtigsten **Markdown** Befehle finden sich auf [[wpde>Markdown]]
   1. **Codeblöcke ausführen** kann man mit Shift / Enter.