Руководство

Фавикон для Nuxt

Nuxt обслуживает статические файлы из /public в корне вашего сайта, поэтому /public/favicon.ico автоматически становится /favicon.ico. Для значков нескольких размеров или SVG добавьте теги ссылок через nuxt.config.ts или useHead() в app.vue.

Быстрый ответ

Чтобы добавить фавиконку в Nuxt 3, поместите favicon.ico в папку /public, при необходимости добавьте теги link в nuxt.config.ts app.head, разверните и проверьте Тестером Favicon.

Проверяйте фавиконки на любом веб-сайте

Установите расширение FetchFavicon для Chrome, чтобы мгновенно извлекать, просматривать и проверять фавиконки.

Установить расширение Chrome

Создайте свой пакет значков с помощью Favicon Generator — экспортируйте favicon.ico, favicon.svg и apple-touch-icon.png из источника 512×512. Поместите их в папку /public вашего проекта Nuxt.

Nuxt 3 обслуживает все, что находится в /public, в корне домена без дополнительной настройки. Браузеры по умолчанию запрашивают /favicon.ico, поэтому размещение файла там охватывает наиболее распространенный случай.

Для явного контроля над каждым вариантом значка добавьте теги ссылок в nuxt.config.ts в app.head.link — или вызовите useHead({ link: [...] }) в app.vue. Оба подхода вставляют теги в <head> каждой страницы.

После развертывания откройте рабочий URL-адрес в личном окне и запустите Favicon Checker, чтобы подтвердить /favicon.ico, и ваши пути <link rel="icon"> возвращают 200. Кэшированные значки разработки являются распространенной причиной того, что значок Nuxt не отображается после развертывания.

Если значок вкладки работает, но Google Search по-прежнему показывает пустой значок, убедитесь, что на вашей действующей домашней странице имеется квадратный значок размером не менее 48×48. Правила сканирования и размера см. в нашем руководстве по требованиям к значкам Google.

Nuxt не создает автоматически файлы .ico разного размера — их необходимо предоставить вам. Используйте резервные варианты PNG, связанные с app.head, для приглашений на установку PWA и вкладок с высоким разрешением.

Как это работает

  1. 1

    Generate favicon files

    Use the Favicon Generator to export favicon.ico and PNG variants from a 512×512 logo.

  2. 2

    Добавить в /public

    Скопируйте favicon.ico (и необязательный favicon.svg, apple-touch-icon.png) в папку Nuxt /public.

  3. 3

    Настроить и проверить

    При необходимости добавьте записи app.head.link в nuxt.config.ts, разверните, а затем запустите Favicon Checker на своем активном URL-адресе.

Platform Dimension Specifications & Compression Benchmark

Standard dimension requirements across search engines, mobile OS, and WebAssembly Oxipng lossless byte reduction.

WebAssembly Oxipng Lossless
Platform Dimension Specifications & Compression Benchmark
Target Platform / OSRequired DimensionsFormat & DeliveryOxipng Wasm WeightByte Savings
Google Search SERP48×48 px (multiples of 48).ico, .png4.6 KB-68.9%
Apple iOS / iPadOS Safari180×180 px.png (apple-touch-icon)14.8 KB-67.9%
Android Chrome & PWA192×192 px & 512×512 px.png (site.webmanifest)59.1 KB-69.3%
Windows Edge & Desktop16×16, 32×32, 48×48 pxMulti-resolution .ico8.8 KB-69.5%
Legacy Web Browsers32×32 px / 16×16 px.ico (/favicon.ico)3.1 KB-67.0%

* Benchmark measurements based on lossless RGBA Oxipng WebAssembly compression executing locally in modern web browsers.

Попробовать сейчас

Generate a Nuxt-ready favicon

Генератор фавиконов

Частые вопросы

Как добавить значок в Nuxt 3?+

Поместите favicon.ico в /public, затем при необходимости добавьте теги <link rel="icon"> в nuxt.config.ts в разделе app.head.link или через useHead() в app.vue.

Куда помещается значок в проекте Nuxt?+

Каталог /public. Файлы там обслуживаются из корня вашего домена — /public/favicon.ico доступен по адресу /favicon.ico.

Почему мой значок Nuxt не отображается?+

Распространенные причины: файл отсутствует в /public, неверный путь в app.head, кеш браузера от разработчика или проверка локального хоста вместо развернутого URL-адреса. Проверьте в окне инкогнито.

Должен ли я использовать nuxt.config.ts или useHead() для значков?+

Либо работает. nuxt.config.ts лучше всего подходит для статических значков всего сайта; useHead() в app.vue, если значки зависят от состояния выполнения или логики маршрута.

Могу ли я использовать значок SVG в Nuxt?+

Да — поместите favicon.svg в /public и добавьте { rel: 'icon', type: 'image/svg+xml', href: '/favicon.svg' } в app.head.link.

Связанные инструменты

Больше руководств

Руководства →