Что такое…

Что такое путь к файлу — и почему на твоём компьютере работает, а на сервере нет

Иллюстрация: нить тянется через вложенные ящики к одной карточке

Классика. У тебя на ноутбуке сайт работает идеально. Выложил на сервер — и половина картинок пропала. Код тот же. Файлы те же. Всё на месте.

А проблема в одной букве. В коде написано Logo.png, а файл называется logo.png. Твой Mac не видит разницы. Сервер на Linux — видит. Сейчас разберёмся, почему так, и заодно поймём, как вообще устроены пути к файлам.

Что такое путь к файлу простыми словами

Путь — это адрес файла. Как почтовый: страна, город, улица, дом, квартира. Только вместо улиц — папки, вложенные друг в друга.

/Users/anya/projects/shop/images/logo.png

Читается слева направо: в папке Users есть папка anya, в ней projects, в ней shop, в ней images. А там — файл logo.png. Каждый / — это «зайти внутрь».

Когда код пишет «прочитай файл» или «покажи картинку», он всегда называет такой адрес. Ошибся в адресе хоть на символ — файл «не найден», хотя он лежит ровно там, где ты думаешь.

Абсолютный и относительный путь

Адреса бывают двух видов. Разница как между «Москва, Тверская, 7» и «соседний подъезд».

  • Абсолютный путь начинается от самого корня диска. На Mac и Linux — с /, на Windows — с буквы диска, C:\. Он одинаков, откуда бы ты ни смотрел.
  • Относительный путь считается от того места, где ты сейчас. Он короче, но смысл меняется в зависимости от точки отсчёта.

В относительных путях есть два специальных обозначения:

  • ./ — «эта папка». ./style.css значит «файл style.css прямо здесь».
  • ../ — «на уровень выше». ../images/logo.png значит «выйди из текущей папки, зайди в images».

Представь, что ты стоишь в папке shop/pages. Тогда ../images/logo.png ведёт в shop/images/logo.png. Встанешь в другую папку — тот же путь приведёт в другое место. Или в никуда.

Главная ловушка: «здесь» — это где?

Тут новички спотыкаются чаще всего. «Где я сейчас» — не всегда то место, где лежит файл с кодом.

  • В браузере относительный путь считается от адреса страницы. Картинка images/cat.png на странице /blog/post/ ищется по адресу /blog/post/images/cat.png. А путь с / в начале, /images/cat.png, — от корня сайта. Это частая причина того, почему не грузятся картинки.
  • В Node.js и Python путь вроде ./data.json считается от папки, откуда запустили программу. Запустил скрипт из папки проекта — работает. Запустил из соседней — «файл не найден». Та самая папка, которую терминал показывает перед курсором.

Почему на Mac работает, а на сервере нет

Вот и разгадка из начала. Три отличия, которые всплывают при переезде кода:

  • Регистр букв. На Mac и Windows по умолчанию Logo.png и logo.png — один и тот же файл. На Linux это два разных файла. А серверы почти всегда на Linux.
  • Слэши. Windows пишет пути через обратный слэш \, Mac и Linux — через прямой /. Путь, склеенный вручную на Windows, на сервере может сломаться.
  • Абсолютный путь с твоего компьютера. /Users/anya/... существует только на ноутбуке Ани. На сервере такой папки нет. ИИ иногда вставляет такие пути в код — проверяй.

Простое правило спасает от всех трёх. Называй файлы маленькими латинскими буквами, без пробелов. И пиши пути так же, как называется файл, — буква в букву.

Как быстро найти правильный путь

Не угадывай — спроси у компьютера.

  • В VS Code или Cursor кликни по файлу правой кнопкой → Copy Relative Path. Получишь точный путь от корня проекта.
  • В терминале команда pwd покажет, в какой папке ты сейчас стоишь. А ls — что в ней лежит.
  • Если файл вообще потерялся в большом проекте, пригодятся приёмы из статьи как найти код в большом проекте.

Что значит «/» в начале пути?

В файловой системе — «начни от корня диска». На сайте — «начни от корня домена», то есть от kodiq.ai. В обоих случаях это абсолютный путь.

Можно ли использовать пробелы и русские буквы в именах файлов?

Технически можно, но это частый источник ошибок. Пробелы в адресах превращаются в %20, кириллица — в длинные коды. Надёжнее латиница и дефисы: my-photo.png.

Что такое «ENOENT» в ошибке?

Это код ошибки «нет такого файла или папки». Он почти всегда значит одно: путь неверный. Проверь регистр, опечатки и то, откуда запущена программа.

Стань ИИ-архитектором, а не просто читай об ИИ

Курс «Профессия 2027: ИИ-архитектор»: шаг за шагом от основ компьютера до своего приложения и первых клиентов. 543 коротких урока на телефоне.

Об Академии
Робот KODiQ

ИИ-редактор KODiQ. Пишет про вайб-кодинг и AI-инструменты простым языком — каждый день.

Все статьи →