0Pricing
React Academy · Lektion

Ordnerstruktur und Namenskonventionen

Organisieren Sie ein React-Projekt mit featurebasierten Ordnern und eindeutigen Dateinamen.

Ordnerstruktur und Namenskonventionen ist eine kostenlose React Academy-Lektion auf CoddyKit. Dies ist Lektion 4 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des React Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Willkommen

In dieser Lektion sehen Sie sich gängige Ordnerstrukturen für React-Projekte an, lernen Namenskonventionen für Dateien und Komponenten kennen und erfahren, wie Sie Code organisieren, wenn das Projekt wächst.

Die Standardstruktur

Ein minimales Vite- und React-Projekt enthält `src/App.jsx` und `src/main.jsx`. Für kleine Demos ist das in Ordnung, aber diese Struktur skaliert nicht. Wenn Sie weitere Funktionen hinzufügen, erstellen Sie eigene Ordner, um zusammengehörigen Code zu bündeln.
src/
  main.jsx
  App.jsx
  index.css

Featurebasierte Struktur

Gruppieren Sie Dateien nach Feature statt nach Dateityp. Jeder Feature-Ordner enthält seine Komponente, Styles, Tests und Hilfsfunktionen. So können Sie ein ganzes Feature einfach auf einmal hinzufügen oder löschen.
src/
  features/
    auth/
      LoginForm.jsx
      LoginForm.test.jsx
      useLogin.js
    dashboard/
      Dashboard.jsx
      useDashboardData.js
  components/     <- shared UI only
  hooks/          <- shared hooks
  lib/            <- utilities

Benennung von Komponentendateien

Benennen Sie Komponentendateien mit **PascalCase**, passend zum Namen der Komponente: `UserCard.jsx`, `NavigationBar.jsx`. Eine Komponente pro Datei ist der Standard. Die Endung `.jsx` (oder `.tsx`) weist Editoren darauf hin, dass die Datei JSX enthält.

Benennung von Dateien ohne Komponenten

Hooks, Hilfsfunktionen und Konstanten verwenden **camelCase**: `useAuth.js`, `formatDate.js`, `apiClient.js`. Testdateien spiegeln ihre Quelldatei mit `.test` oder `.spec`: `useAuth.test.js`.

Indexdateien für übersichtliche Imports

Wenn Sie einem Ordner eine `index.js` hinzufügen, können Sie über den Ordnerpfad statt über den vollständigen Dateipfad importieren. Beschränken Sie Indexdateien ausschließlich auf Re-Exports – sie sollten keine Logik enthalten.
// src/features/auth/index.js
export { LoginForm } from './LoginForm';
export { useLogin } from './useLogin';

// Consumer
import { LoginForm } from '@/features/auth';

Absolute Imports mit Pfadaliasen

Konfigurieren Sie in `vite.config.js` und `tsconfig.json` einen `@/`-Alias, der auf `src/` verweist. Dadurch vermeiden Sie fragile relative Pfade wie `../../../../components/Button`.
// vite.config.js
resolve: {
  alias: { '@': path.resolve(__dirname, 'src') }
}

Gemeinsam verwendete Komponenten vs. Feature-Komponenten

Legen Sie Komponenten, die nur in einem Feature verwendet werden, in den Ordner dieses Features. Verschieben Sie eine Komponente erst dann nach `src/components/`, wenn sie von mindestens zwei Features benötigt wird. Vermeiden Sie eine vorzeitige Auslagerung.

Konstanten- und Konfigurationsdateien

Speichern Sie Magic Strings, API-Basis-URLs und Wrapper für Umgebungsvariablen in `src/lib/constants.js` oder `src/config.js`. Verteilen Sie Zeichenfolgen wie `process.env.VITE_API_URL` niemals über viele Dateien.
// src/config.js
export const API_BASE = import.meta.env.VITE_API_URL;

Typen und Interfaces (TypeScript)

Ordnen Sie Typen in TypeScript-Projekten dem Feature oder der Komponente zu, die sie verwendet. Erstellen Sie für gemeinsam verwendete Typen, die in vielen Features vorkommen, den Ordner `src/types/` mit einer Datei pro Fachbereich.

Schnelltest

Was ist der wichtigste Vorteil einer featurebasierten Ordnerstruktur gegenüber einer nach Dateityp strukturierten Ordnerstruktur?

Zusammenfassung

Verwenden Sie featurebasierte Ordner, PascalCase für Komponentendateien, camelCase für Hooks und Hilfsfunktionen, `index.js`-Re-Exports für übersichtliche Imports sowie einen Pfadalias wie @/, um lange relative Pfade zu vermeiden.

Kurs abgeschlossen

Herzlichen Glückwunsch! Sie haben **React Strict Mode & Best Practices** abgeschlossen. Sie verstehen jetzt das Verhalten von StrictMode, wissen, wie Sie reine Renderfunktionen schreiben und Schlüssel und Refs korrekt verwenden, und kennen eine skalierbare Ordnerstruktur.

Häufig gestellte Fragen

Ist die Lektion „Ordnerstruktur und Namenskonventionen“ kostenlos?

Ja — der vollständige Text von „Ordnerstruktur und Namenskonventionen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des React Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der React Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Ordnerstruktur und Namenskonventionen“?

Organisieren Sie ein React-Projekt mit featurebasierten Ordnern und eindeutigen Dateinamen. Du übst React Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um React Academy zu starten?

Keine Vorkenntnisse erforderlich. React Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 4 von 4.

Wie lange dauert die Lektion „Ordnerstruktur und Namenskonventionen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser React Academy-Lektion Code schreiben und ausführen?

Ja. Jede React Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

  1. Was StrictMode bewirkt
  2. Pure Components und Seiteneffekte beim Rendern vermeiden
  3. Best Practices für Keys und Refs
  4. Ordnerstruktur und Namenskonventionen
← Zurück zu React Academy