WOFF2 не загружается

Если WOFF2 не загружается, откройте Network, найдите файл шрифта и проверьте его адрес, HTTP-ответ и тип содержимого. Затем сравните правило @font-face и фактический шрифт во вкладке Computed. Если файл загружен, а часть букв остаётся в запасной гарнитуре, проверьте поддерживаемые символы, начертание и диапазоны Unicode.
Зафиксируйте страницу и вид проблемы
Откройте рабочую страницу в той среде, где пропал шрифт. Запишите элемент, ожидаемую гарнитуру и признаки ошибки. Например, заголовок обычный, а жирный выглядит иначе, или русский текст отличается только по начертанию от латинского. Добавьте контрольную фразу «Ёж, чай и заказ № 42» и несколько букв латиницы. Для теста жирного добавьте то же содержимое с другим весом. Если проблема зависит от ширины, посмотрите страницу на двух размерах и проверьте фактически применённые стили.
Подберите два соседних элемента: один работает, второй подозрителен. В каталоге шрифтов можно сравнить указанные возможности семейств. Однако страница использует именно ту версию файла, которую загрузили в проект или получили из внешнего CSS. Если существует несколько сборок шрифта, уточните их имена и назначение. Материал о проверке Google Fonts с кириллицей показывает отдельно, как проверять внешнее подключение и фактическое отображение знаков.
Для воспроизведения прогоните ту же страницу после полной перезагрузки с выключенным кешем при открытой панели инструментов. Не добавляйте сразу второй комплект шрифтов, иначе будет труднее понять, какая декларация использовалась. Начните с одного семейства и одного начертания. После проверки расширьте пример на остальные места. Если один язык работает, а другой визуально отличается, переходите к фактическому составу файла после сетевой проверки.
Проверьте загрузку и каскад CSS
Найдите именно тот файл, который открывает браузер
В Chrome откройте DevTools → Network, выберите фильтр Font, перезагрузите страницу. Откройте строку нужного WOFF2 и посмотрите Request URL, Status Code и Content-Type. Для WOFF2 ожидаемый тип — font/woff2. Если вместо бинарного файла показывается HTML, проверьте маршрут и ответ сервера. В обычной вкладке прямой адрес может предложить скачивание. Для диагностики используйте тот же URL, к которому обратился браузер, а не похожий путь из списка файлов.
Относительный url(...) в загруженной таблице стилей относится к адресу самой таблицы. Если CSS лежит в /assets/css/, путь ../fonts/example.woff2 ведёт в /assets/fonts/. Перенос файла стилей или объединение сборщиком может поменять конечный путь. Проверьте имя файла, регистр и есть ли он в опубликованном каталоге. В Console посмотрите сообщения об ошибках загрузки, разборе шрифта и политике источников. При использовании стороннего домена установите, что источник действительно разрешён настройками проекта и сервером ресурса.
Если строки WOFF2 нет, проверьте, нужен ли этот шрифт текущему тексту. Браузер может не открывать некоторые лица, если ни один элемент их не использует или символы не попадают в заданный unicode-range. В тесте оставьте одну фразу и правило с явной гарнитурой. Появилась строка файла — проверьте ответ. Не появилась — посмотрите, применилось ли правило и не перекрывает ли его стиль компонента.
Сверьте @font-face и фактический шрифт
В примере имя Demo задаётся в @font-face и используется точно так же в правиле элемента. Файл нормального начертания относится к весу 400. Для другого веса подставьте отдельный файл или укажите корректный диапазон вариативной гарнитуры, если она его поддерживает. Справка MDN по @font-face описывает src, format, font-weight и другие дескрипторы.
@font-face {
font-family: "Demo";
src: url("/assets/fonts/demo-regular.woff2") format("woff2");
font-weight: 400;
font-style: normal;
font-display: swap;
}.article { font-family: "Demo", system-ui, sans-serif; }
Откройте Elements → Computed. Посмотрите назначенное font-family и найденные Rendered Fonts. Если правило объявления соответствует имени, а в фактическом списке виден только запасной шрифт, вернитесь к ошибкам файла и поддержке символов. Если список содержит два семейства, проверьте русские буквы и знак валюты в отдельных коротких элементах. В Linux можно использовать следующие команды, чтобы отличить контейнер WOFF2 от HTML и посмотреть сведения, если установленный Fontconfig может разобрать файл.
file "sample.woff2"
fc-query --format '%{family}\n%{lang}\n' "sample.woff2"
В локальной проверке оба учебных файла распознавались командой file как WOFF2. Fontconfig показал семейство Inter Variable и язык ru для первого, Noto Sans Symbols2 без языкового списка — для второго. Это иллюстрирует разницу между форматом и набором знаков. Проверка на своём сайте выполняется через конкретный ресурс и реальный текст в браузере. Команда просмотра файла не может определить, какая копия использована в каждом элементе.
Проверьте preload только после исправления загрузки
Если для главного шрифта уже есть link rel=«preload», сравните его адрес с тем, что указан в CSS. Для шрифтов MDN описывает crossorigin у preload, чтобы режим предварительной загрузки совпадал с последующим обращением. Слишком много preload могут вытеснять важные файлы. Начните с одной действительно нужной гарнитуры, затем сравните Network с текущим вариантом. Документация MDN по preload содержит пример для шрифта.
Если загрузка подтвердилась, сравните шрифт при первой отрисовке и после получения файла. При font-display: swap запасная гарнитура в начале ожидаема. Различия в длине строк и высоте блоков оцените на реальном компоненте. Карточка Typescale пригодится для подбора размеров, когда техническая загрузка уже восстановлена. Сохраните рабочий пример с нужными весами и проверьте его после следующей сборки. Если в разных разделах свои сборки CSS, откройте два характерных шаблона и сравните адрес шрифта.
Если ошибку 404 возвращает иконочный шрифт из webfonts, сверьте структуру папок при подключении Font Awesome.
Как выбрать проверку
| Задача | Что выбрать | Ограничение |
|---|---|---|
| WOFF2 отсутствует в Network | Проверить CSS, используемый вес и текст | Браузер загружает нужные файлы по мере применения |
| Файл вернул 404 или HTML | Сверить путь, регистр и опубликованный каталог | Вид расширения в строке не подтверждает содержимое |
| Один язык использует запасной шрифт | Проверить Rendered Fonts и набор знаков | CSS-семейство не гарантирует наличие конкретного символа |
| Жирный выглядит не так | Проверить дескриптор веса и нужный файл | Статический и вариативный файлы объявляются по-разному |
| Шрифт запрашивается дважды | Сравнить адрес и режим preload с CSS | Предварительную загрузку добавляют после исправления файла |
Чего не получилось и почему
Распознавание локального контейнера WOFF2 не подтверждает, что сайт публикует его под нужным URL. Проверьте итоговый браузерный ответ и список фактических шрифтов. При ошибке из-за другого домена согласуйте корректный источник. Если файл доступен, но часть текста отрисовывается иначе, сравните версию, стиль и диапазон знаков. Это часто объясняет, почему проблема касается только конкретной буквы. После исправления одной буквы проверьте остальные строки, которые используют тот же файл: формат цен, кавычки, цифры и слова на обоих языках.
Вопросы о WOFF2
Почему путь в HTML работает, а путь из CSS нет?
Относительный путь из внешнего CSS разрешается от адреса таблицы стилей. Скопируйте точный URL из Network и сравните с опубликованной папкой.
Что означает, если WOFF2 пришёл, но шрифта нет?
Проверьте фактический формат и Console. Затем сравните назначенную гарнитуру и вес в Computed и фактический список Rendered Fonts.
Как проверить отдельно кириллицу и латиницу?
Возьмите два коротких элемента в одном стиле. Сравните фактические шрифты по каждому. Для смешанной строки проверьте ещё специальные знаки.
Можно ли публиковать один WOFF2 на всё?
Это зависит от покрытия знаков и нужных весов. Сначала протестируйте реальные названия, цифры, знаки и жирные выделения.
Что делать дальше
- Посмотреть библиотеку шрифтов FontLibrary и подобрать гарнитуру с нужным языковым набором.
- Взять готовый промт для графики сайта, если помимо шрифта нужно проверить читаемость заголовка на фоне.
- Найти исполнителя для диагностики веб-шрифтов, если проблема затрагивает несколько шаблонов или сборок.
