·2 Min. Lesezeit
Modul-Importe in Next.js mit eigenen Path-Aliases vereinfachen
So machst du Importpfade in Next.js mit eigenen Path-Aliases kürzer und lesbarer. Schritt für Schritt mit tsconfig, Beispielen und typischen Stolperfallen.

Hast du keine Lust mehr auf lange Importpfade wie "../../../components/ui/test" in deinen Next.js-Projekten? Dann freu dich, denn es gibt eine Lösung, die deine Importe vereinfacht und deinen Code deutlich aufgeräumter macht: Path-Aliases.
In Next.js kannst du mit Path-Aliases eigene Abkürzungen für deine Importpfade definieren, damit sie kürzer und lesbarer werden. Statt dich durch mehrere Verzeichnisse zu hangeln, um eine Komponente zu importieren, nutzt du einfach einen definierten Alias**.**
Einrichtung
tsconfig.json anpassen: Öffne die tsconfig.json deines Projekts und füge die Eigenschaft "paths" hinzu, falls sie noch nicht existiert. Mit dieser Eigenschaft definierst du deine eigenen Path-Aliases.
{ "compilerOptions": { "baseUrl": ".", "paths": { "@/*": ["components/*"] } }}In diesem Beispiel haben wir einen Alias „@“ definiert, der auf das Verzeichnis „components“ zeigt. Alias und Verzeichnispfad kannst du an deine Projektstruktur anpassen.
Den Alias verwenden: Statt langer Importpfade kannst du jetzt deinen definierten Alias nutzen. Statt zum Beispiel:
import { Component } from '../../../components/ui/test';schreibst du jetzt einfach:
import { Component } from '@/components/ui/test';Indem du den Alias „@“ mit dem relativen Pfad dahinter kombinierst, werden deine Importe sofort kürzer und leichter verständlich.
Nachdem du die tsconfig.json geändert hast, vergiss nicht, deinen Development-Server neu zu starten, damit die Änderungen greifen.
Und das war’s! Mit eigenen Path-Aliases in deinen Next.js-Projekten verbesserst du die Lesbarkeit und Wartbarkeit deines Codes deutlich. Also los: Vereinfache deine Importe und konzentrier dich mehr darauf, großartige Features für deine Next.js-Anwendungen zu bauen.


