Kategoria: Next.js, React i TypeScript

Next.js: global CSS import w niewłaściwym komponencie

Poradnik techniczny · Kacper Bernecki

Po dodaniu nowego arkusza pojawia się błąd dotyczący lokalizacji globalnego CSS lub kolejności stylów. Reguły importowania globalnych stylów zależą od Pages Router, App Router i konfiguracji bundlera.

Jak rozpoznać źródło problemu

Sprawdź czy projekt używa katalogu app czy pages i w jakim komponencie pojawia się globalny import. Zidentyfikuj konflikt dwóch globalnych arkuszy oraz kolejność ich ładowania po nawigacji.

Porównaj komunikat z konsoli z wynikiem kompilacji produkcyjnej oraz stanem po odświeżeniu strony.

Kroki naprawcze

Przenieś globalne style do właściwego entry point frameworka lub użyj CSS Modules dla pojedynczych komponentów. Jeśli konflikt wynika z kolejności stylów, uprość zależności i ustal spójny punkt importu dla całej witryny.

Jak przetestować rozwiązanie

Build i nawigacja między podstronami nie zgłaszają błędu CSS, a wygląd nie zależy od kolejności wejścia.

Bezpieczeństwo i ograniczenia

Nie zamieniaj wszystkich stylów na !important, bo ukryje to konflikt zamiast go rozwiązać.