Гайды

Как разбить код на файлы — export и import за 6 шагов, без поломок

Иллюстрация: длинный свиток разрезан на аккуратные листы, и каждый лёг в свою папку

Ты собирал проект с ИИ, и в какой-то момент app.js разросся до 1500 строк. Нейросеть начинает путаться: правит не то, забывает начало файла, ломает соседнее. А ты сам уже листаешь по пять минут, чтобы найти нужную функцию.

Лечится это одним приёмом — разбить файл на несколько маленьких. Звучит страшно, но механика простая: два слова, export и import. Пройдём по шагам на живом примере.

Как файлы видят друг друга

Сначала одна важная мысль. Каждый файл-модуль — это закрытая комната. Всё, что в нём объявлено, снаружи не видно.

Чтобы поделиться функцией, файл должен явно её выставить наружу словом export. А другой файл должен явно её позвать словом import. Нет пары export — import, значит, связи нет.

Это не бюрократия, а защита. Ты всегда видишь, откуда что пришло. И никакая функция не залезет туда, куда её не звали.

Разбиваем файл: пошагово

Допустим, в app.js вперемешку лежат форматирование цен, работа с корзиной и отрисовка страницы.

  1. Найди швы. Пробегись по файлу и сгруппируй функции по теме. Всё про форматирование — одна кучка. Всё про корзину — другая. Каждая кучка станет файлом. Не дроби мельче, чем нужно: файл на 5 строк — тоже неудобно.

  2. Создай новый файл и перенеси туда кучку. Например, utils/format.js. Перенеси функции целиком — вырезать и вставить.

  3. Поставь export перед тем, что нужно снаружи.

    // utils/format.js
    export function formatPrice(value) {
      return value.toLocaleString("ru-RU") + " ₽"
    }
    

    Вспомогательные функции, которые нужны только внутри файла, оставь без export. Пусть сидят в своей комнате.

  4. Импортируй в старом файле. В самом верху app.js:

    import { formatPrice } from "./utils/format.js"
    

    Путь здесь считается от файла, который импортирует, а не от папки, откуда ты запустил программу. ./ — «рядом со мной». Если с путями плывёшь — загляни в разбор, что такое путь к файлу.

  5. Запусти и проверь. Открой страницу или запусти скрипт. Если всё работает как раньше — шаг удался. Сразу сделай коммит, чтобы было куда откатиться.

  6. Повтори для следующей кучки. По одному файлу за раз. Перенёс — проверил — закоммитил. Не переноси всё разом: если сломается, не поймёшь, где.

Три ошибки, которые вылезут почти наверняка

Не пугайся красного текста — это обычный этап. Вот что он обычно значит. Подробнее о том, как такие сообщения читать, — в статье как читать сообщение об ошибке.

  • Cannot find module или Failed to resolve import. Путь неверный. Проверь ./, имя папки и расширение .js. В чистом браузере и Node расширение обязательно. Сборщики вроде Vite разрешают его не писать.
  • does not provide an export named .... Ты импортируешь то, чего файл не выставил наружу. Забыт export или опечатка в имени.
  • Cannot use import statement outside a module. Среда не знает, что это модули. В браузере нужен <script type="module">. В Node — "type": "module" в package.json. В проектах на React или Vite это уже настроено.

Именованный и default export

Ты увидишь два вида экспорта. Разница — в фигурных скобках.

  • Именованный: export function formatPrice. Импорт — строго по имени, в скобках: import { formatPrice } from .... Из одного файла можно выставить сколько угодно.
  • По умолчанию: export default function Cart. Импорт без скобок, имя любое: import Cart from .... Такой в файле только один.

Простое правило для новичка: пиши именованные. С ними опечатка сразу даёт ошибку, а не тихую путаницу.

Попроси ИИ сделать это за тебя

Разбивка файла — классический рефакторинг: код меняет форму, но не поведение. ИИ с этим справляется хорошо, если сказать ему это прямо.

Слабый промптРаздели app.js на файлы
Сильный промптРаздели app.js на несколько файлов по теме: форматирование, корзина, отрисовка. Правила: 1) поведение программы не меняется ни в одной мелочи; 2) используй именованные export и import с явным расширением .js; 3) не переименовывай функции; 4) сначала покажи план: какие функции в какой файл уйдут, и жди моего ок; 5) переноси по одному файлу за шаг.

Пункт про план — самый важный. Ты увидишь раскладку до того, как ИИ начнёт резать. И поймаешь странность вроде «функция оплаты уехала в утилиты» до того, как она случилась.

На сколько файлов разбивать?

Ориентир — когда файл перестаёт помещаться в голове и на один-два экрана. Обычно это 200–300 строк. Но важнее смысл: один файл — одна тема.

Что такое циклический импорт?

Это когда файл A импортирует B, а B — снова A. Код может запуститься, но какая-то функция окажется undefined. Лечится выносом общей части в третий файл.

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

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

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

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

Все статьи →