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

Классика. У тебя на ноутбуке сайт работает идеально. Выложил на сервер — и половина картинок пропала. Код тот же. Файлы те же. Всё на месте.
А проблема в одной букве. В коде написано 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 коротких урока на телефоне.





