diff --git a/04b_umstieg_vscode/README.md b/04b_umstieg_vscode/README.md index a95865f..ba131db 100644 --- a/04b_umstieg_vscode/README.md +++ b/04b_umstieg_vscode/README.md @@ -1,58 +1,87 @@ -# Kapitel 04b: Umstieg von Thonny auf Visual Studio Code (VS Code) 🚀💻 +# Kapitel 04b: Umstieg & Installation von Visual Studio Code (VS Code) 🚀💻 -Herzlich willkommen zum Exkurs! +Herzlich willkommen zum Praxis-Guide! Bisher hast du deine Aufgaben vielleicht in **Thonny** bearbeitet. Thonny ist super für die ersten Schritte. Aber ab jetzt werden unsere Projekte größer (mehrere Dateien, Klassen, Tests). -**Visual Studio Code (VS Code)** ist die beliebteste und mächtigste Entwicklungsumgebung der Welt. Hier lernst du, wie du sie einrichtest und wie ein Profi nutzt! +**Visual Studio Code (VS Code)** von Microsoft ist die beliebteste und modernste Entwicklungsumgebung der Welt. Hier erfährst du, wie du sie installierst und einrichtest. --- -## 🏗️ Das wichtigste Grundkonzept: "Ordner öffnen" (Open Folder) +## 📥 1. Installation Schritt-für-Schritt -- In Thonny öffnet man meistens nur einzelne Dateien (wie `aufgabe.py`). -- In **VS Code öffnet man immer den gesamten Projektordner**: - 1. Starte VS Code. - 2. Klicke auf **Datei → Ordner öffnen...** (oder `Strg + K`, dann `Strg + O` / auf Mac: `Cmd + O`). - 3. Wähle den Ordner `Aufgaben-Python` aus. +### 🪟 Für Windows (Windows 10 / 11): +1. Gehe auf [code.visualstudio.com](https://code.visualstudio.com) und lade den **Windows Installer** herunter. +2. Starte die Datei `VSCodeUserSetup-x64-...exe`. +3. **⚠️ SEHR WICHTIG:** Setze im Schritt *"Zusätzliche Aufgaben"* alle 4 Haken: + - [x] *Aktion 'Mit Code öffnen' zum Windows Explorer-Dateikontextmenü hinzufügen* + - [x] *Aktion 'Mit Code öffnen' zum Windows Explorer-Verzeichniskontextmenü hinzufügen* + - [x] *Code als Editor für unterstützte Dateitypen registrieren* + - [x] *Zu PATH hinzufügen* +4. Klicke auf **Installieren** und **Fertigstellen**. -Jetzt hast du links im Explorer die volle Übersicht über alle Kapitel! +### 🍎 Für macOS (MacBook / iMac): +1. Lade auf [code.visualstudio.com](https://code.visualstudio.com) die Mac-Version (`.zip`) herunter. +2. Entpacke die Datei im Downloads-Ordner. +3. **⚠️ Wichtig:** Ziehe die Datei `Visual Studio Code.app` in deinen Ordner **Programme (Applications)**! +4. Starte VS Code aus dem Programme-Ordner. + +### 🐧 Für Linux (Ubuntu / Debian): +```bash +sudo apt update && sudo apt install snapd +sudo snap install --classic code +``` --- -## 🧩 Die besten Erweiterungen (Extensions) +## 🇩🇪 2. Sprache auf Deutsch umstellen (Optional) -Drücke `Strg + Shift + X` (Mac: `Cmd + Shift + X`), um den Erweiterungs-Store zu öffnen. Installiere folgende Plugins: - -1. **Python & Pylance (von Microsoft):** - Aktiviert Autovervollständigung (IntelliSense), Syntaxprüfung und den Ausführen-Button. -2. **Error Lens (⭐ Geheimtipp!):** - Zeigt Fehler und Warnungen direkt als Text in der Codezeile an! Du musst nicht erst lange im Terminal nach Zeilennummern suchen. -3. **Material Icon Theme:** - Hübsche, bunte Datei-Symbole für Python, Markdown, HTML und Git. -4. **Better Comments:** - Färbt `# TODO`, `# !` und `# ?` farblich ein. -5. **Black Formatter:** - Formatiert deinen Code beim Speichern automatisch sauber und ordentlich. +1. Drücke `Strg + Shift + P` (Mac: `Cmd + Shift + P`). +2. Tippe: `Configure Display Language` und drücke `Enter`. +3. Wähle `Deutsch (German)` aus und starte VS Code neu. --- -## ⌨️ Die wichtigsten Tastenkombinationen (Shortcuts) +## 📁 3. Das Projekt in VS Code öffnen + +- In Thonny öffnet man meistens nur einzelne Dateien (`aufgabe.py`). +- In **VS Code öffnet man immer den gesamten Hauptordner**: + 1. Klicke oben auf **Datei → Ordner öffnen...** (Mac: `Cmd + O`). + 2. Wähle den Ordner `Aufgaben-Python` aus. + 3. Bestätige *"Vertrauen Sie den Autoren"* mit **Ja**. + +Jetzt siehst du links im Explorer alle Kapitel und Dateien! + +--- + +## 🧩 4. Die besten Erweiterungen (Extensions) + +Drücke `Strg + Shift + X` (Mac: `Cmd + Shift + X`), um den Extension-Store zu öffnen: + +1. **Python & Pylance (von Microsoft):** IntelliSense, Syntaxprüfung & Ausführen. +2. **Error Lens (⭐ Must-Have!):** Zeigt Fehler direkt farbig in der Zeile an. +3. **Material Icon Theme:** Bunte Datei-Symbole. +4. **Better Comments:** Farbige Kommentare (`# TODO`, `# !`). +5. **Black Formatter:** Automatisches Formatieren beim Speichern (`Strg + S`). + +--- + +## ⌨️ 5. Die wichtigsten Shortcuts | Aktion | Windows / Linux | macOS | | :--- | :--- | :--- | | **Datei speichern** | `Strg + S` | `Cmd + S` | | **Terminal öffnen / schließen** | `Strg + \`` (oder `Strg + J`) | `Cmd + \`` (oder `Cmd + J`) | | **Command Palette (Befehle suchen)** | `Strg + Shift + P` | `Cmd + Shift + P` | -| **Code formatieren** | `Alt + Shift + F` | `Option + Shift + F` | +| **Code automatisch formatieren** | `Alt + Shift + F` | `Option + Shift + F` | | **Nächstes gleiches Wort markieren** | `Strg + D` | `Cmd + D` | -| **Skript ausführen** | `Strg + F5` (oder Play-Button oben) | `Cmd + F5` | +| **Skript starten** | `Strg + F5` (oder Play-Button ▶️) | `Cmd + F5` | --- -## 🧪 Ausprobieren in `vscode_test.py` +## 🧪 6. Ausprobieren in `vscode_test.py` Öffne `vscode_test.py` in VS Code und teste: 1. Wie **Error Lens** Fehler in Echtzeit anzeigt. -2. Wie **IntelliSense** Methoden vorschlägt, wenn du `auto.` tippst. -3. Öffne das Terminal mit `Strg + \`` und führe `python3 test_all.py` aus! +2. Wie **IntelliSense** Methoden vorschlägt, wenn du `tesla.` tippst. +3. Öffne das Terminal mit `Strg + \`` und führe `python3 04b_umstieg_vscode/vscode_test.py` aus! diff --git a/04b_umstieg_vscode/index.html b/04b_umstieg_vscode/index.html index 7719495..09aaa11 100644 --- a/04b_umstieg_vscode/index.html +++ b/04b_umstieg_vscode/index.html @@ -3,7 +3,7 @@ - Kapitel 04b: Umstieg auf Visual Studio Code + Kapitel 04b: Umstieg & Installation von Visual Studio Code @@ -19,9 +19,9 @@ › Kapitel 05 → -
Exkurs & Praxissprung
+
Installation & Setup

Umstieg von Thonny auf Visual Studio Code 🚀💻

-

Willkommen in der Profi-Entwicklungsumgebung! Lerne die besten Plugins, Shortcuts und Arbeitsabläufe kennen.

+

Schritt-für-Schritt-Installationsanleitung (Windows, Mac, Linux), die besten Plugins und Profi-Tipps.

@@ -32,56 +32,135 @@

1. Warum wechseln wir von Thonny zu VS Code?

- Thonny war für den Anfang genial: Es ist einfach, hat einen Variablen-Inspektor und man kann Zeile für Zeile durch ein Skript gehen. + Thonny war für den Einstieg super: Es ist schlank und man sieht Variablen sofort.

- Doch je größer deine Projekte werden (mehrere Dateien, Klassen, Tests und Git), desto mehr stößt Thonny an seine Grenzen. Visual Studio Code (VS Code) ist der weltweite Standard in der professionellen Softwareentwicklung. + Aber ab jetzt werden unsere Projekte größer (mehrere Dateien, Klassen, Tests und Git). Visual Studio Code (VS Code) von Microsoft ist die weltweit beliebteste Entwicklungsumgebung für Python.

-
🏎️ Vom Fahrschulauto zum Rennwagen:
+
🏎️ Die 4 größten Vorteile von VS Code:
- -

Die 4 größten Vorteile von VS Code:

- - +
-

2. Das wichtigste Grundkonzept: "Ordner öffnen" (Open Folder)

+

2. 📥 Schritt-für-Schritt Installationsanleitung

+ +

Wähle dein Betriebssystem aus und befolge die Schritte:

+ + +
+ 🪟 Anleitung für Windows 10 / 11 +
+
    +
  1. + Gehe auf die offizielle Website: code.visualstudio.com und klicke auf den blauen Button "Download for Windows". +
    2. +
  2. + Starte die heruntergeladene Installationsdatei (VSCodeUserSetup-x64-...exe). +
    3. +
  3. + Akzeptiere die Lizenzvereinbarung und klicke auf Weiter. +
    4. +
  4. +
    +
    ⚠️ Sehr wichtig bei der Windows-Installation:
    + Setze im Schritt "Zusätzliche Aufgaben auswählen" unbedingt alle Haken: +
      +
    • ✓ Aktion "Mit Code öffnen" zum Windows Explorer-Dateikontextmenü hinzufügen
      • +
    • ✓ Aktion "Mit Code öffnen" zum Windows Explorer-Verzeichniskontextmenü hinzufügen
      • +
    • ✓ Code als Editor für unterstützte Dateitypen registrieren
      • +
    • ✓ Zu PATH hinzufügen (nach Neustart verfügbar)
      • +
    +
    +
    5. +
  5. + Klicke auf Installieren und danach auf Fertigstellen (VS Code startet automatisch). +
    6. +
+
+
+ + +
+ 🍎 Anleitung für macOS (MacBook / iMac) +
+
    +
  1. + Gehe auf code.visualstudio.com und lade "Download for Mac" herunter (Universal). +
    2. +
  2. + Öffne deinen Downloads-Ordner und entpacke die .zip-Datei (falls nicht automatisch geschehen). +
    3. +
  3. +
    +
    💡 Wichtig für Mac-Nutzer:
    + Ziehe die Datei Visual Studio Code aus dem Downloads-Ordner in deinen Ordner Programme (Applications)! +
    +
    4. +
  4. + Öffne VS Code aus dem Programme-Ordner. (Falls eine Warnung erscheint: Klicke auf "Öffnen"). +
    5. +
+
+
+ + +
+ 🐧 Anleitung für Linux (Ubuntu / Debian / Mint) +
+

Lade das .deb-Paket von code.visualstudio.com herunter und doppelklicke darauf, oder installiere es direkt per Terminal:

+
+ 
sudo apt update && sudo apt install snapd
+sudo snap install --classic code
+
+
+
+ + +
+
🇩🇪 Sprache auf Deutsch umstellen (Optional):
+ Wenn du VS Code auf Deutsch haben möchtest: +
    +
  1. Drücke Strg + Shift + P (Mac: Cmd + Shift + P).
    2. +
  2. Tippe: Configure Display Language und drücke Enter.
    3. +
  3. Wähle Deutsch (German) aus. VS Code startet kurz neu und ist komplett auf Deutsch!
    4. +
+
+
+ + +
+

3. 📁 Das Projekt in VS Code öffnen

-
⚠️ Wichtigster Unterschied zu Thonny:
- In Thonny hat man meist nur eine einzelne Datei geöffnet (z.B. aufgabe.py).
- In VS Code öffnet man immer den gesamten Projektordner (z.B. Aufgaben-Python)! +
⚠️ Grundregel: Immer "Ordner öffnen", nicht nur eine Datei!
+ In VS Code öffnet man immer den gesamten Hauptordner (Aufgaben-Python), damit alle Kapitel, Hilfsdateien und Tests auf einmal verknüpft sind.
-

So öffnest du dein Projekt richtig:

-
    -
  1. Starte Visual Studio Code.
    2. -
  2. Klicke im Menü oben auf Datei → Ordner öffnen... (oder Strg + K, dann Strg + O / auf Mac: Cmd + O).
    3. -
  3. Wähle den Hauptordner Aufgaben-Python aus und klicke auf Öffnen.
    4. -
  4. Bestätige eventuell die Frage "Vertrauen Sie den Autoren?" mit Ja.
    5. +
      +
    1. Klicke oben im Menü auf Datei → Ordner öffnen... (Mac: File → Open Folder...).
      2. +
    2. Wähle deinen Ordner Aufgaben-Python aus und klicke auf Ordner auswählen.
      3. +
    3. Bestätige die Meldung "Vertrauen Sie den Autoren dieser Dateien?" mit Ja.
    -

    Jetzt siehst du links im Explorer alle Kapitelordner, Tests und Dateien sauber aufgelistet!

    +

    Jetzt siehst du links in der Leiste den gesamten Dateibaum aller Kapitel!

- +
-

3. 🧩 Die unverzichtbaren Erweiterungen (Plugins)

+

4. 🧩 Die wichtigsten Erweiterungen (Plugins)

- Um Erweiterungen zu installieren, klicke ganz links in der Seitenleiste auf das Erweiterungs-Icon (die vier Quadrate mit einem fliegenden Würfel) oder drücke Strg + Shift + X (Mac: Cmd + Shift + X). + Klicke ganz links in der Seitenleiste auf das Erweiterungs-Icon (die 4 Kacheln) oder drücke Strg + Shift + X (Mac: Cmd + Shift + X).

+

Suche nach den folgenden Namen und klicke jeweils auf Installieren (Install):

@@ -89,8 +168,8 @@
🐍
-

Python (von Microsoft)

-

Pflicht-Plugin! Aktiviert Syntax-Highlighting, Code-Ausführung, IntelliSense und Debugging.

+

1. Python (von Microsoft)

+

Pflicht! Aktiviert Syntax-Hervorhebung, Code-Ausführung und IntelliSense.

@@ -98,8 +177,8 @@
⚡
-

Pylance (von Microsoft)

-

Macht die Autovervollständigung blitzschnell und warnt dich sofort bei falschen Typen.

+

2. Pylance (von Microsoft)

+

Macht die Autovervollständigung blitzschnell und warnt bei falschen Parametern.

@@ -107,8 +186,8 @@
🔍
-

Error Lens Geheimtipp!

-

Zeigt Fehler und Warnungen direkt als farbigen Text in der Codezeile an – kein Suchen im Terminal nötig!

+

3. Error Lens Must-Have!

+

Zeigt Fehler direkt farbig in der Codezeile an – du musst nicht lange suchen!

@@ -116,8 +195,8 @@
🎨
-

Material Icon Theme

-

Verleiht Python-, HTML- und Git-Dateien im Explorer hübsche und bunte Symbole.

+

4. Material Icon Theme

+

Gibt allen Dateien im Explorer schöne, bunte Symbole (Python-Logo, HTML-Icon etc.).

@@ -125,8 +204,8 @@
💬
-

Better Comments

-

Färbt Kommentare ein: # TODO: wird orange, # ! wird rot, # ? wird blau.

+

5. Better Comments

+

Färbt Kommentare ein: # TODO (orange), # ! (rot), # ? (blau).

@@ -134,46 +213,17 @@
🪄
-

Black Formatter

-

Formatiert deinen Code beim Speichern (Strg+S) automatisch nach den offiziellen Python-Regeln.

+

6. Black Formatter

+

Formatiert Code beim Speichern (Strg+S) automatisch perfekt.

- -
-

4. 🖥️ Die Benutzeroberfläche im Überblick

- - -
-
-

5. ⌨️ Die wichtigsten Tastenkombinationen (Shortcuts)

- -

Mit diesen Shortcuts codest du wie ein echter Profi:

+

5. ⌨️ Tastenkombinationen (Shortcuts) für Profis

@@ -195,7 +245,7 @@ - + @@ -210,8 +260,8 @@ - - + + @@ -228,38 +278,32 @@
  • -
    • -
  • - -
    • -
    🎉 Perfekt vorbereitet!
    - Du beherrschst nun die Grundlagen von VS Code. Jetzt bist du bereit für Kapitel 05 (Objekte kombinieren)! +
    🎉 Perfekt eingerichtet!
    + Du bist jetzt mit modernem Profi-Werkzeug ausgestattet und bereit für Kapitel 05 (Objekte kombinieren)!
    Cmd + ` (oder Cmd + J)
    ⚡ Command Palette (Alles suchen)⚡ Command Palette (Befehle suchen) Strg + Shift + P Cmd + Shift + P
    Cmd + D
    🚀 Skript direkt ausführenStrg + F5 (oder Play-Button oben rechts)🚀 Skript direkt startenStrg + F5 (oder Play-Button ▶️) Cmd + F5