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

Ты собирал проект с ИИ, и в какой-то момент app.js разросся до 1500 строк. Нейросеть начинает путаться: правит не то, забывает начало файла, ломает соседнее. А ты сам уже листаешь по пять минут, чтобы найти нужную функцию.
Лечится это одним приёмом — разбить файл на несколько маленьких. Звучит страшно, но механика простая: два слова, export и import. Пройдём по шагам на живом примере.
Как файлы видят друг друга
Сначала одна важная мысль. Каждый файл-модуль — это закрытая комната. Всё, что в нём объявлено, снаружи не видно.
Чтобы поделиться функцией, файл должен явно её выставить наружу словом export. А другой файл должен явно её позвать словом import. Нет пары export — import, значит, связи нет.
Это не бюрократия, а защита. Ты всегда видишь, откуда что пришло. И никакая функция не залезет туда, куда её не звали.
Разбиваем файл: пошагово
Допустим, в app.js вперемешку лежат форматирование цен, работа с корзиной и отрисовка страницы.
-
Найди швы. Пробегись по файлу и сгруппируй функции по теме. Всё про форматирование — одна кучка. Всё про корзину — другая. Каждая кучка станет файлом. Не дроби мельче, чем нужно: файл на 5 строк — тоже неудобно.
-
Создай новый файл и перенеси туда кучку. Например,
utils/format.js. Перенеси функции целиком — вырезать и вставить. -
Поставь
exportперед тем, что нужно снаружи.// utils/format.js export function formatPrice(value) { return value.toLocaleString("ru-RU") + " ₽" }Вспомогательные функции, которые нужны только внутри файла, оставь без
export. Пусть сидят в своей комнате. -
Импортируй в старом файле. В самом верху
app.js:import { formatPrice } from "./utils/format.js"Путь здесь считается от файла, который импортирует, а не от папки, откуда ты запустил программу.
./— «рядом со мной». Если с путями плывёшь — загляни в разбор, что такое путь к файлу. -
Запусти и проверь. Открой страницу или запусти скрипт. Если всё работает как раньше — шаг удался. Сразу сделай коммит, чтобы было куда откатиться.
-
Повтори для следующей кучки. По одному файлу за раз. Перенёс — проверил — закоммитил. Не переноси всё разом: если сломается, не поймёшь, где.
Три ошибки, которые вылезут почти наверняка
Не пугайся красного текста — это обычный этап. Вот что он обычно значит. Подробнее о том, как такие сообщения читать, — в статье как читать сообщение об ошибке.
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 коротких урока на телефоне.





