re:re:actable
Урок 044 минуты чтения

Как делать SEO во Vue SPA и Nuxt

На этой странице
Кратко

В Vue SPA (Vite + Vue Router) HTML пустой, поэтому для SEO нужно: History-режим роутера, мета-теги на каждый маршрут через @unhead/vue, настоящие ссылки <RouterLink>, серверный fallback на index.html и корректные 404, а для публичных страниц — prerender или переход на SSR. Nuxt решает основу из коробки: SSR по умолчанию, гибридный рендеринг через routeRules, useSeoMeta/useHead при SSR, правильные статусы через createError, модули Nuxt SEO для sitemap, robots, Schema.org и OG-картинок. Подробный разбор Nuxt — в разделе Nuxt: SEO.

Вопрос

Как сделать SEO во Vue SPA и в Nuxt?

Vue SPA: обязательный минимум

// router.ts — History API вместо #
import { createRouter, createWebHistory } from "vue-router";
 
export const router = createRouter({
  history: createWebHistory(),
  routes: [
    { path: "/", component: () => import("./pages/Home.vue") },
    { path: "/products/:slug", component: () => import("./pages/Product.vue") },
    { path: "/:pathMatch(.*)*", component: () => import("./pages/NotFound.vue") },
  ],
});
<!-- Product.vue -->
<script setup lang="ts">
import { useSeoMeta, useHead } from "@unhead/vue";
 
const product = await loadProduct(route.params.slug);
 
useSeoMeta({
  title: () => `${product.value?.title} — купить`,
  description: () => product.value?.description,
  ogImage: () => product.value?.image,
});
useHead({ link: [{ rel: "canonical", href: () => `https://shop.example.com${route.path}` }] });
</script>
  • Сервер (Nginx, CDN) отдаёт index.html на любой путь — значит, 404 не будет; для несуществующих страниц добавляют noindex в компоненте NotFound или отдают 404 на уровне сервера по списку маршрутов.
  • Для публичных страниц — prerender при сборке (vite-ssg и аналоги) или переход на Nuxt.

Nuxt: что даёт фреймворк

ЗадачаNuxt
Контент в HTMLSSR по умолчанию
Режимы по разделамrouteRules: prerender, swr, isr, ssr: false
Мета-тегиuseSeoMeta, useHead, titleTemplate — при SSR
404throw createError({ statusCode: 404 })
РедиректыnavigateTo(url, { redirectCode: 301 }), routeRules.redirect
Sitemap, robots@nuxtjs/sitemap, @nuxtjs/robots
Structured datanuxt-schema-org
OG-картинкиnuxt-og-image
Скорость@nuxt/image, @nuxt/fonts, @nuxt/scripts, lazy hydration
// nuxt.config.ts
export default defineNuxtConfig({
  modules: ["@nuxtjs/seo"],
  site: { url: "https://shop.example.com", name: "Магазин" },
  routeRules: {
    "/": { prerender: true },
    "/blog/**": { prerender: true },
    "/catalog/**": { swr: 600 },
    "/account/**": { ssr: false, robots: false },
  },
});
<script setup lang="ts">
const route = useRoute();
const { data: post } = await useFetch(() => `/api/posts/${route.params.slug}`);
if (!post.value) throw createError({ statusCode: 404, fatal: true });
 
useSeoMeta({ title: () => post.value?.title, description: () => post.value?.excerpt });
</script>

Общие правила для обоих

  • Ссылки — <RouterLink>/<NuxtLink>, рендерят <a href>.
  • Уникальные title, description, canonical на каждый маршрут.
  • Мета-теги вычисляются из данных, загруженных до рендера (в Nuxt — await useFetch).
  • Проверка итогового HTML через curl и URL Inspection.

Частые ошибки

  • createWebHashHistory() в публичном SPA.
  • Один title в index.html на все страницы.
  • В Nuxt — загрузка контента с server: false или в onMounted.
  • Пустая страница «Не найдено» со статусом 200.

Что важно помнить

  • Vue SPA можно привести к приемлемому SEO, но это ручная работа; Nuxt даёт это по умолчанию.
  • Режим рендеринга выбирается по разделам: публичное — SSR/SSG, закрытое — CSR.
  • Мета-теги и статусы должны быть в серверном ответе.

Мини-шпаргалка

  • SPA: History API, @unhead/vue, prerender, 404-стратегия.
  • Nuxt: SSR, routeRules, useSeoMeta, createError, Nuxt SEO.
  • <a href>, уникальные мета, проверка HTML.

Связанные темы

Документация

Nuxt: SEO and Meta, Vue: SSR guide, Unhead.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам