Если сайт «падает» после подключения сторонней библиотеки — верстка съезжает, скрипты не выполняются, форма перестаёт отправляться — почти всегда причина в одном из трёх мест: файл библиотеки не загрузился, версия конфликтует с другим кодом на странице, либо подключение сделано в неправильном порядке. Открывайте консоль разработчика (F12) и вкладку Console — там будет конкретная ошибка.
Как понять, что проблема именно в библиотеке
Откройте страницу, нажмите F12, перейдите на вкладку Console. Красные строки с текстом вроде Uncaught ReferenceError или $ is not defined означают, что скрипт, который её использует, выполнился раньше, чем загрузилась сама библиотека, либо она вообще не подгрузилась. Вкладка Network покажет статус запроса к файлу библиотеки — если там 404 или CORS-ошибка, файл просто недоступен по указанному пути.
Uncaught ReferenceError: jQuery is not defined
at script.js:12
Частые причины
- Библиотека подключена через CDN, который недоступен или изменил адрес файла
- Скрипт с зависимостью от библиотеки стоит в HTML выше самой библиотеки
- Одновременно подключены две версии одной библиотеки — они перезаписывают друг друга
- Файл библиотеки лежит на хостинге, но путь указан неверно после переноса сайта
- Content Security Policy (CSP) сайта блокирует загрузку внешнего скрипта
- Кэш браузера или CDN отдаёт старую, битую версию файла
Как исправить
Проверьте порядок подключения: сама библиотека (например jQuery, Swiper, GSAP) должна стоять в <head> или перед закрывающим </body> раньше любых скриптов, которые её используют. Если ошибка 404 — откройте прямую ссылку на файл библиотеки в новой вкладке и убедитесь, что она действительно отдаёт код, а не 404/403. При использовании CDN попробуйте временно скачать файл и подключить локально — это сразу покажет, проблема во внешнем сервере или в самом коде сайта. Очистите кэш сочетанием Ctrl+F5 и проверьте на другом устройстве или через режим инкогнито, чтобы исключить локальный кэш браузера.
Если после исправления сайт всё равно не работает
Отключайте подключённые скрипты по одному, начиная с последнего добавленного, и проверяйте страницу после каждого отключения — так быстрее всего находится конкретный конфликтующий файл. Если сайт на WordPress или другом CMS, проверьте, не обновился ли плагин, который подключает эту библиотеку: часто после автообновления меняется путь к файлу или версия перестаёт совпадать с остальным кодом темы.