Lista kontrolna SEO w Next.js (App Router)

Lista kontrolna SEO w Next.js dla App Router, z kodem | We.Inc

Lista SEO dla App Router: metadata i generateMetadata, metadataBase, szablony tytułów, canonical, hreflang, sitemap.ts, robots.ts i obrazy OG, z kodem.

Lista kontrolna SEO w Next.js (App Router)

W App Router tagi SEO pochodzą z eksportowanego obiektu metadata lub funkcji generateMetadata w plikach layout i page, które działają tylko w Server Components. Ustaw metadataBase raz w głównym layoucie, dodaj app/sitemap.ts i app/robots.ts, nadaj każdej trasie canonical przez alternates i umieść plik opengraph-image obok stron, które go potrzebują.

Gdzie znajduje się każdy element

  • Potrzeba
  • Plik lub pole w App Router
  • Tytuł i opis
  • export const metadata lub generateMetadata w page.tsx albo layout.tsx
  • Bazowy URL dla linków względnych
  • metadataBase w app/layout.tsx
  • Canonical i hreflang
  • alternates.canonical i alternates.languages
  • app/sitemap.ts zwracający MetadataRoute.Sitemap
  • app/robots.ts zwracający MetadataRoute.Robots
  • Obraz do udostępniania
  • opengraph-image.png, .jpg, .gif lub .tsx w folderze trasy

App Router ma wbudowane rozwiązania niemal każdego technicznego zadania SEO, ale są one rozrzucone po kilkunastu stronach dokumentacji. Ta lista zbiera je w kolejności, z kodem do skopiowania dla każdego punktu, a pola wyboru pozwalają śledzić postępy we własnym projekcie.

  • Przechodź po liście i zaznaczaj każdy punkt, gdy jest gotowy. Zaznaczenia zostają tylko w tej karcie.
  • Najpierw skopiuj kod głównego layoutu, bo metadataBase i szablon tytułu wpływają na wszystkie pozostałe trasy.
  • Dodaj pliki sitemap i robots, a potem otwórz /sitemap.xml i /robots.txt na serwerze deweloperskim, aby przeczytać wynik.
  • Wyświetl źródło kilku tras, aby potwierdzić, że tytuł, canonical i tagi og są w HTML.
  • Obiekty metadata scalają się płytko. Jeśli strona ustawia openGraph, zastępuje cały obiekt openGraph z layoutu, więc rozwijaj wspólne pola ze wspólnego pliku.
  • title.template w layoucie dotyczy segmentów potomnych, a nie własnej strony layoutu, i wymaga obok siebie title.default.
  • Użycie względnego adresu URL w polu metadata bez metadataBase powoduje błąd builda, co jest przydatnym wczesnym ostrzeżeniem.
  • Zostaw page.tsx jako Server Component, aby dało się eksportować metadata, a hooki i obsługę zdarzeń przenieś do osobnego pliku komponentu klienckiego.

Najczęściej zadawane pytania

Czy mogę użyć generateMetadata w komponencie klienckim?

Nie. Obiekt metadata i generateMetadata są obsługiwane tylko w Server Components, bo Next.js musi je rozwiązać na serwerze przed renderowaniem. Zostaw stronę jako Server Component i zaimportuj komponent kliencki dla części interaktywnych.

Dlaczego params w generateMetadata jest obiektem Promise?

Obecne wersje Next.js przekazują params i searchParams jako obiekty Promise, więc wewnątrz asynchronicznej generateMetadata piszesz const { slug } = await params. Kod napisany dla starszych wersji, który odczytuje params.slug bezpośrednio, wymaga aktualizacji.

Jak w Next.js zrobić mapę witryny z ponad 50,000 adresów URL?

Użyj generateSitemaps w pliku sitemap.ts. Zwraca ona listę identyfikatorów, a domyślny eksport buduje jedną mapę witryny na każdy identyfikator. W Next.js 16 identyfikator przychodzi jako Promise. Pliki są serwowane pod ścieżkami takimi jak /product/sitemap/1.xml.

Czy Next.js automatycznie dodaje tag canonical?

Nie, chyba że go ustawisz. Dodaj alternates.canonical w metadata każdej trasy, zwykle jako ścieżkę względną, na przykład /blog/my-post, i pozwól metadataBase zamienić ją w pełny URL.

Czy mogę eksportować jednocześnie metadata i generateMetadata?

Nie, segment trasy może eksportować jedno albo drugie. Używaj statycznego obiektu, gdy nic nie zależy od żądania ani pobranych danych, a generateMetadata, gdy zależy.

Najpierw statycznie, dynamicznie tam, gdzie trzeba

  • Większość stron marketingowych może korzystać ze statycznego obiektu metadata. Po generateMetadata sięgaj w trasach dynamicznych, takich jak /blog/[slug] lub /products/[id], gdzie tytuł pochodzi z danych.
  • Wywołania fetch wewnątrz generateMetadata są memoizowane razem z tym samym żądaniem na stronie, więc wczytanie wpisu dla metadata i ponownie do renderowania nie podwaja pracy.

Renderowanie nadal ma znaczenie

  • Server Components wysyłają prawdziwy HTML, a to właśnie on jest najpierw czytany przez roboty i narzędzia do podglądu linków. Treść pojawiająca się dopiero po pobraniu po stronie klienta jest odkrywana wolniej i niewidoczna dla aplikacji, które nie uruchamiają JavaScriptu.
  • Od wersji 15.2 metadata z generateMetadata mogą być strumieniowane po pierwszym HTML dla przeglądarek. Dla botów, które nie potrafią uruchomić JavaScriptu, takich jak facebookexternalhit, Next.js nadal umieszcza tagi w sekcji head, rozpoznając je po user agencie.

Kod dla każdego punktu

Główny layout: metadataBase, szablon tytułu, wartości domyślne

Ustawiane raz w app/layout.tsx. Strony potomne eksportujące title: "Pricing" wyświetlają się jako Pricing | Northside.

Trasa dynamiczna: generateMetadata z canonical

Na params czekamy przez await. getPost oznacza Twoją własną funkcję pobierającą dane.

app/sitemap.ts

Zwraca jeden wpis na każdy URL. changeFrequency i priority są opcjonalne i Google je ignoruje, więc zostały pominięte.

app/robots.ts

Generuje robots.txt w katalogu głównym strony.

app/blog/[slug]/opengraph-image.tsx

Rysuje obraz do udostępniania 1200 na 630 z tytułu wpisu za pomocą ImageResponse z next/og. Eksporty alt, size i contentType stają się tagami og.

Limity plików graficznych

Obrazy do udostępniania oparte na plikach

  • Plik
  • Typy
  • Limit rozmiaru
  • .jpg, .jpeg, .png, .gif or .js, .ts, .tsx
  • 8 MB (powyżej build się nie udaje)
  • .jpg, .jpeg, .png, .gif or .js, .ts, .tsx
  • 5 MB (powyżej build się nie udaje)
  • .txt
  • Staje się og:image:alt

metadataBase ustawione w app/layout.tsx

Pozwala, by każde inne pole URL było ścieżką względną

Szablon tytułu i wartość domyślna w głównym layoucie

Daje każdej stronie spójną końcówkę, na przykład | Acme

Unikalny tytuł i opis na każdej stronie

Statyczne metadata lub generateMetadata dla każdej trasy

Canonical na każdej indeksowanej trasie

hreflang dla przetłumaczonych tras

alternates.languages albo w mapie witryny

app/sitemap.ts wymienia tylko działające adresy canonical

Przy dużej liczbie podziel za pomocą generateSitemaps

app/robots.ts z linią sitemap

Blokuje tylko obszary takie jak /admin lub /api

Obraz Open Graph dla kluczowych tras

Plik opengraph-image z tekstem alternatywnym

noindex na ubogich lub prywatnych trasach

robots: { index: false } w metadata tej trasy

Treść renderowana na serwerze

Sprawdź źródło strony, a nie tylko widok w przeglądarce

Lista kontrolna

Gotowe: {count} z {total}

Zbuduj stronę za darmo · Za darmo, bez karty

Powiązane: Poradniki

Produkt

Dla kogo

Funkcje

Zasoby

Firma

Mapa strony