TypeScript: alias paths działa w edytorze, ale Node nie znajduje modułu
Poradnik techniczny · Kacper Bernecki
TS i IDE rozwiązują @/lib/config, lecz uruchomiony skrypt Node zgłasza MODULE_NOT_FOUND. paths w tsconfig służą do rozwiązywania typów i nie gwarantują zamiany importów w wygenerowanym kodzie Node.
Jak ustalić źródło błędu
Sprawdź rozbieżność między ts-node, bundlerem, tsc i node uruchamiając dokładnie komendę produkcyjną.
Podejrzyj wygenerowane pliki JS, aby zobaczyć, czy alias pozostał w specyfikatorze importu.
Co zrobić krok po kroku
1. Skonfiguruj zgodne aliasy w narzędziu runtime/bundlera lub użyj bezpośrednich importów względnych.
2. Dla kodu ESM rozważ poprawne package imports i spójną konfigurację eksportów pakietu.
Jak sprawdzić wynik
Skrypt po zbudowaniu uruchamia się bez dodatkowych hacków, a moduł jest rozwiązywany tak samo na CI i lokalnie.
Czego nie robić
Nie zakładaj, że samo baseUrl/paths w tsconfig zmienia działanie importów w czystym Node.js.