ФронтендHTML / CSS

Live Server в VS Code: как установить, запустить сайт и исправить Open with Live Server

Устанавливаем Live Server, открываем папку сайта, запускаем index.html и исправляем отсутствие кнопки Go Live, неверный корень, порт и автообновление.

Кодик

Автор

6 мин чтения

Для запуска Live Server установите расширение Live Server, откройте в VS Code всю папку сайта, выберите index.html и выполните Open with Live Server или нажмите Go Live. Если команды нет, сначала проверьте, что расширение включено и файл действительно имеет расширение .html. Если открывается 404, проблема чаще всего в корне рабочей папки или пути к файлу, а не в HTML.

Двойной клик по HTML открывает адрес вида file:///.... Для статической страницы этого иногда достаточно, но относительные пути, запросы и поведение браузера удобнее проверять через локальный HTTP-сервер. Live Server запускает такой сервер и перезагружает страницу после сохранения файлов.

1Установить

Найти расширение Live Server в Marketplace и убедиться, что оно Enabled.

2Открыть папку

Рабочая область должна начинаться с корня сайта, а не с одного случайного файла.

3Запустить HTML

Использовать Go Live или контекстную команду для index.html.

Установка расширения и первый запуск

Откройте Extensions сочетанием Ctrl+Shift+X или Cmd+Shift+X, найдите Live Server и проверьте издателя расширения. После установки откройте папку через File, Open Folder. В Explorer должен быть виден index.html, а не только вкладка файла из неизвестного каталога.

<!doctype html>
<html lang="ru">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Проверка Live Server</title>
</head>
<body>
  <h1>Сервер работает</h1>
</body>
</html>
ШагЧто должно быть видноЕсли не видно
УстановкаКнопка Disable или UninstallРасширение ещё не активно
Открытие папкиДерево проекта в ExplorerИспользуйте Open Folder
Выбор файлаАктивная вкладка index.htmlПроверьте расширение файла
ЗапускGo Live или команда в менюПерезагрузите окно VS Code
БраузерАдрес http://127.0.0.1:портПроверьте уведомление и порт

Установка и запуск Live Server в VS Code по шагам
Расширение запускается после открытия корневой папки и выбора HTML-файла.

Не путайте Live Server с запуском JavaScript через Node.js. Live Server обслуживает файлы и открывает их в браузере. Он не превращает frontend-код в серверное приложение и не устанавливает npm-зависимости. Для проекта с Vite, Next.js или другим фреймворком используйте команду запуска самого проекта.

Почему нужно открыть папку, а не один HTML-файл

Правильная структура первого сайта
  1. Создайте отдельную папку проекта без посторонних файлов.
  2. Положите index.html в выбранный корень.
  3. Создайте рядом каталоги css, js и images при необходимости.
  4. Откройте именно эту папку в VS Code через Open Folder.
  5. Проверьте относительные пути от текущего HTML-файла.
  6. Запустите index.html и сохраните небольшое изменение.

Корень сервера определяет, как URL сопоставляется с файлами. Если открыта слишком высокая папка, адрес страницы получает лишний сегмент. Если слишком низкая, ссылка ../images/logo.png может выйти за доступный корень. Для первого сайта удобнее хранить index.html и каталоги ресурсов внутри одной папки.

my-site/
├── index.html
├── css/
│   └── styles.css
├── js/
│   └── app.js
└── images/
    └── logo.png

Связь корня сайта структуры папок и URL Live Server
URL строится относительно открытого корня, поэтому структура проекта должна быть предсказуемой.

URL должен соответствовать структуре от корня

Если файл лежит в pages/about.html, его адрес обычно содержит /pages/about.html. Ошибка 404 означает, что сервер не нашёл путь в выбранном корне. Сначала откройте index.html из Explorer, затем переходите по относительным ссылкам.

Что делать, если нет Go Live или Open with Live Server

Команда может отсутствовать, если расширение отключено для текущей рабочей области, VS Code требует перезагрузки, открыт не HTML-файл или рабочая среда ограничивает расширения. Откройте карточку расширения и посмотрите статус, затем вызовите Command Palette и найдите команды Live Server по имени.

СимптомПроверкаДействие
Нет Go LiveСтатус расширенияEnable и Reload Window
Нет контекстной командыАктивный файлОткрыть настоящий файл .html
Открывается 404Путь в адресной строкеПереоткрыть корень папки
Порт занятУведомление или OutputОстановить старый сервер или сменить порт
Страница не обновляетсяСохранён ли файлВключить Auto Save или нажать Save
CSS не меняетсяNetwork и путь к stylesheetИсправить href и очистить кэш
<!-- Пути считаются от index.html -->
<link rel="stylesheet" href="./css/styles.css">
<script src="./js/app.js" defer></script>
<img src="./images/logo.png" alt="Логотип проекта">

Диагностика Go Live 404 порта и автообновления
Симптом направляет к статусу расширения, Output VS Code или Network браузера.

Смотрите Output расширения, а не только браузер. Если сервер не стартовал или сменил порт, диагностическое сообщение находится в VS Code. Если сервер работает, но ресурс даёт 404, откройте Network в браузере и сравните запрошенный URL с деревом файлов.

Почему автообновление не срабатывает

Live reload реагирует на сохранённые изменения файлов, а не на каждый набранный символ, если Auto Save выключен. Иногда страница открыта не с Live Server, а через file:// или другой порт. Ещё один частый случай: CSS подключён по неверному пути, поэтому HTML обновляется, но редактируется не тот файл стилей.

Открывать HTML двойным кликом

Адрес file:// не связан с запущенным Live Server и не получит его автообновление.

Запускать сервер для Vite-проекта

Фреймворк ожидает собственный dev server, сборку модулей и переменные окружения.

Менять порт наугад

Сначала остановите старый экземпляр и посмотрите Output. Новый порт меняет origin.

Исправлять CSS без проверки пути

Браузер может загружать другой файл или получать 404. Проверьте Network.

Надёжная проверка начинается с адресной строки

Убедитесь, что URL начинается с http://, принадлежит текущему порту и указывает на нужный файл. Затем сохраните заметное изменение текста. Если HTML обновился, сервер и live reload работают, а отдельную проблему CSS или JS можно разбирать дальше.

Когда Live Server подходит, а когда нужен другой сервер

Live Server удобен для статических HTML, CSS и обычного браузерного JavaScript. Он не реализует API, базу данных, серверные маршруты и сборку npm-пакетов. Если в package.json есть script dev, сначала прочитайте README проекта и используйте указанную команду.

Чек-лист рабочего локального сайта
  1. Расширение установлено, включено и VS Code перезагружен при необходимости.
  2. В рабочей области открыта одна корневая папка сайта.
  3. index.html имеет корректное расширение и виден в Explorer.
  4. Страница открыта по http, а не file.
  5. Сохранение HTML вызывает видимое обновление в браузере.
  6. CSS, JS и изображения возвращают статус 200 во вкладке Network.
Локальный сервер не публикует сайт в интернет. Адрес 127.0.0.1 или localhost предназначен для вашего компьютера. Чтобы поделиться проектом, нужен хостинг или репозиторий и отдельный процесс публикации. Не отправляйте знакомому localhost-ссылку.
Короткие ответы
Что делает Live Server?

Запускает локальный HTTP-сервер для файлов и обычно обновляет страницу после сохранения.

Почему важен Open Folder?

Открытая папка задаёт понятный корень проекта и относительных путей.

Что проверить, если нет Go Live?

Статус расширения, перезагрузку окна, тип активного файла и доступность команды в Command Palette.

Почему страница не обновляется?

Файл мог быть не сохранён, страница открыта через file:// или подключён другой ресурс.

Подходит ли Live Server для Vite?

Обычно нет. Vite запускают собственной командой dev из проекта.

Соберите маленький сайт и проверьте каждый ресурс

Создайте страницу по пошаговому руководству HTML, CSS и JavaScript и закрепите основы в курсе HTML. Для динамики пригодится статья о DOM.

Если скрипт подключён, но кнопка не работает, переходите к разбору типичных багов JavaScript. В Кодике удобно держать структуру файлов и браузерный URL рядом, чтобы сразу замечать неверный корень.