Иконки Font Awesome пропали

Если иконки Font Awesome перестали отображаться, проверьте три вещи: существует ли иконка в подключённом наборе, соответствует ли класс её стилю и загрузились ли файлы. Начните с известной иконки fa-solid fa-house. Если она появилась, сравните с нужной. Если пропала и она, ищите причину в подключении общего CSS, шрифта или Kit.
Если библиотека ещё не подключена в новом шаблоне, сначала проверьте способы подключения Font Awesome и выбор класса иконки.
Воспроизведите сбой на одной кнопке
Откройте страницу в той версии, в которой пользователь видит ошибку. Запишите, что именно произошло: пустое место, квадратик, другой значок или пропажа при определённой ширине экрана. Сравните две кнопки. На первую поставьте известный рабочий значок, на вторую — проблемный. Так два элемента получат один CSS и будут проверяться в одинаковом окружении. Если размеры отличаются, установите одинаковый размер текста и проверьте, что контейнер не обрезает значок.
В справочнике «Иконки Font Awesome» откройте house в стиле Solid. В проверенной карточке пункт «HTML-класс» показывал строку с fa-solid fa-house, а кнопка «Копировать код» даёт готовый фрагмент. «Скачать SVG» открывает отдельный файл. Для теста вставьте класс на простую страницу того же проекта, который должен подгружать нужный набор. У незнакомой иконки сначала проверьте её имя и стиль по справочнику. Размеры, цвет и положение редактируйте после того, как значок стабильно появился.
Например, добавьте такой фрагмент в пробную разметку, где Font Awesome уже подключён. Ссылка остаётся понятной, даже если графика не загрузится. В aria-hidden скрыт только декоративный значок, а видимая фраза даёт ссылке доступное имя.
<a href="/catalog/">
<i class="fa-solid fa-house" aria-hidden="true"></i>
Каталог
</a>
Проверьте класс, файлы и настройки
Сопоставьте имя и стиль
Откройте DevTools и во вкладке Elements выберите элемент с классами. Сравните итоговую строку с тем, что вставили. Система шаблонов могла отфильтровать часть классов или оставить старое имя. Значки в стилях Solid и Regular могут различаться по доступности. У логотипов брендов проверьте соответствующий класс из раздела Brands. Один и тот же стиль нельзя подставлять ко всем названиям без сверки. Проверьте в официальной карточке, входит ли иконка в установленную редакцию и версию. Справка Font Awesome о сбоях предлагает проверять комплект, версию и ограниченный состав Kit.
При обновлении сайта сначала выясните, какой пакет загружается реально. Проект может содержать CSS новой версии и старую копию webfonts в опубликованном каталоге. Для теста сравните имена и пути из CSS с теми файлами, которые отдаёт сайт. Если используете Kit, проверьте, включена ли выбранная иконка или группа стилей в его настройках. Пример, открытый в каталоге, подтверждает класс из этого каталога. Он не проверяет состав вашего проекта или подписки.
Проверьте сетевую загрузку
Во вкладке Network включите Disable cache при открытой панели, перезагрузите страницу и найдите таблицу стилей или подключаемый Kit. У режима Web Fonts + CSS проверьте также файлы шрифтов. Щёлкните по строке и откройте Headers и Response. Если CSS или файл шрифта отсутствует, сначала исправьте его публичный адрес или выкладку. Подмена ответа страницей входа или обработчиком неизвестного адреса иногда маскируется успешным кодом. Смотрите содержимое и тип ответа вместе.
В схеме с локальными файловыми пакетами путь из url(...) в CSS разрешается относительно местоположения самой таблицы стилей. После склейки стилей или переноса между каталогами прежний путь может стать неверным. Начните с того файла, на который реально обратился браузер. Если в Console видны сообщения о проверке источника или политике безопасности, согласуйте разрешённую конфигурацию с разработчиком. Для нескольких страниц проверьте одну в корне и одну во вложенном разделе. Так можно обнаружить относительные пути, которые работают на одной странице.
В режиме с Kit и SVG вместо шрифтового символа может появиться svg-элемент. Тогда список шрифтов в Network мало говорит о конкретной иконке. Сравните итоговую разметку Elements и загрузку ресурсов выбранного режима. Если другим шаблоном вставлена вторая версия библиотеки, проверьте, нет ли конфликтов. Убирайте только подтверждённый дубль в черновой сборке, затем проверяйте меню, кнопки и блоки со значками. В одном проекте разные страницы могут использовать разные части набора.
Сравните подготовленный SVG и вариант с классом
Скачайте house в SVG и вставьте в пробную страницу как изображение. Если SVG виден, а HTML-класс пустой, графический файл готов, а цепочку импорта классов нужно продолжить проверять. Если оба варианта не видны в компоненте, посмотрите размеры, видимость, цвет, обрезку контейнера. Для набора статичных пиктограмм можно рассмотреть SVG-спрайт для сайта, особенно если нужно общее подключение фигур без шрифтов. В существующем проекте сначала подтвердите, в какой части схемы возникла ошибка, чтобы не заменять рабочий набор целиком.
Для нескольких проверочных значков из разных коллекций используйте каталог библиотек иконок. Подберите графику, которая визуально подходит интерфейсу, а при переходе на другую библиотеку проверяйте её собственные правила подключения. Если нужна одна иконка рядом с текстом, держите контрольную кнопку на стенде. Проверьте её при наведении, клавиатурном фокусе, смене темы и на мобильном экране. Если значок исчезает только при фокусе, ищите правило конкретного состояния, а не неисправность общего пакета.
Если сбой заметили после обновления, сравните страницу до и после на одном размере экрана. На копии можно временно оставить только контрольную кнопку и то подключение, которое она действительно использует. При успешной пробе добавляйте правила текущей темы по частям. Так станет видно, не скрывает ли значок отдельный класс адаптивной версии. Если тест снова ломается после добавления одного файла, запишите его имя и конкретное правило в Computed.
Как различать симптомы
| Задача | Что выбрать | Ограничение |
|---|---|---|
| Пусто у одной иконки | Сверить имя, стиль, версию и состав набора | Рабочая версия на сайте может отличаться от справочника |
| Пусто у всех иконок | Проверить загрузку CSS, Kit и файлов шрифта | Способ подключения определяет, какие ресурсы искать |
| На месте знака квадрат | Сверить шрифт, псевдоэлемент и файлы | Квадрат не показывает точную причину сам по себе |
| После выкладки изменились значки | Проверить версии CSS и шрифта и порядок подключения | Старая копия ресурса может остаться в кеше |
| Нужен один независимый рисунок | Скачать и проверить SVG | SVG потребует собственного способа размещения и окраски |
Чего не получилось и почему
Пример с house подтверждает, как работает выдача HTML-класса в справочнике. Он не показывает, что выбранный набор подключён к клиентской странице. Для подтверждения последнего откройте итоговый HTML и проверьте ответ файлов. Если внедрение через сторонний Kit зависит от доступа проекта, полагайтесь на его реальные настройки и допустимые домены. В этой инструкции не заявлены цены, права на платные наборы или особенности доступа из России.
Одна табличка Network показывает именно посещённую страницу. Если набор сломан только в карточке, проверьте её шаблон, а не главную. Запишите рядом с исправлением точный значок и кнопку, где был сбой. Следующая публикация может заменить общий CSS или повлиять на порядок подключения. Повторная проверка по известному примеру помогает отличить воспроизведение от нового случая.
Вопросы о пропавших иконках
Почему один значок работает, а другой нет?
Сравните стиль, имя и доступность во включённом наборе. Если один значок в тесте отображается, полностью отсутствующее подключение менее вероятно.
Можно ли просто менять fa-solid на fa-regular?
Посмотрите, есть ли нужный вариант Regular в вашей версии. В разных стилях доступны разные наборы.
Что делать, если пропал только значок без видимой подписи?
Проверьте доступное имя ссылки или кнопки. Затем подтвердите загрузку графики. Получатель должен понимать действие, даже если изображение временно не появилось.
Почему работает SVG, а класс не работает?
У SVG есть собственные контуры. HTML-класс зависит от CSS, шрифта или Kit. Проверьте именно эту цепочку.
Что делать дальше
- Посмотреть наборы иконок для сайта и сравнить формы, если нужен независимый SVG-вариант.
- Взять готовый промт для графики и описать единый стиль дополнительных пиктограмм.
- Найти исполнителя для проверки иконок в интерфейсе, если ошибка затронула несколько шаблонов и состояний.
