bundle-barrel-imports — правило Claude Code: что делает и установка
Правило bundle-barrel-imports для Claude Code подсказывает импортировать модули напрямую, а не через barrel-файлы. Указывает прямые пути модулей в React-пакетах и библиотеках с большим числом реэкспортов.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/bundle-barrel-imports.mdЧто делает bundle-barrel-imports
bundle-barrel-imports проверяет импорт из библиотек и направляет к прямым путям исходных модулей. Вместо import { Button } from '@mui/material' правило предлагает import Button from '@mui/material/Button'. Так в граф загрузки попадают только нужные модули.
Правило также описывает настройку optimizePackageImports для Next.js 13.5+, при которой можно оставить привычные barrel-импорты. В списке затронутых библиотек есть lucide-react, @mui/material, lodash, date-fns и rxjs.
Для внешней библиотеки tree-shaking не помогает: сборщик не может оптимизировать её содержимое. Поэтому прямые импорты особенно важны, если пакет не попадает в бандл.
Какие задачи решает
- находить импорты через barrel-файлы
- заменять реэкспорты прямыми путями
- сокращать число загружаемых модулей
- настраивать импорты пакетов в Next.js
Примеры запросов агенту
- Проверь импорты в проекте и замени barrel-файлы прямыми путями.
- Найди импорты из
@mui/materialи предложи безопасные прямые варианты. - Проверь, можно ли включить
optimizePackageImportsдляlucide-reactвnext.config.js.
Как установить bundle-barrel-imports
Вручную: положить файлы
.claude/rules/bundle-barrel-imports.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/bundle-barrel-imports.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/bundle-barrel-imports.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/bundle-barrel-imports.mdВручную: положить файлы
.clinerules/bundle-barrel-imports.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о bundle-barrel-imports
Как установить bundle-barrel-imports в Claude Code?
Добавьте правило по пути .claude/rules/bundle-barrel-imports.md.
Что делает bundle-barrel-imports?
Правило помогает не загружать тысячи неиспользуемых модулей через barrel-файлы и подсказывает прямые импорты из исходных файлов.
Почему tree-shaking не всегда решает проблему barrel-импортов?
Для внешней библиотеки сборщик не может оптимизировать содержимое. Если включить её в бандл ради tree-shaking, анализ всего графа модулей замедляет сборку.
Исходный текст
bundle-barrel-imports.md · MIT
---
title: Avoid Barrel File Imports
impact: CRITICAL
impactDescription: 200-800ms import cost, slow builds
tags: bundle, imports, tree-shaking, barrel-files, performance
---
## Avoid Barrel File Imports
Import directly from source files instead of barrel files to avoid loading thousands of unused modules. **Barrel files** are entry points that re-export multiple modules (e.g., `index.js` that does `export * from './module'`).
Popular icon and component libraries can have **up to 10,000 re-exports** in their entry file. For many React packages, **it takes 200-800ms just to import them**, affecting both development speed and production cold starts.
**Why tree-shaking doesn't help:** When a library is marked as external (not bundled), the bundler can't optimize it. If you bundle it to enable tree-shaking, builds become substantially slower analyzing the entire module graph.
**Incorrect (imports entire library):**
```tsx
import { Check, X, Menu } from 'lucide-react'
// Loads 1,583 modules, takes ~2.8s extra in dev
// Runtime cost: 200-800ms on every cold start
import { Button, TextField } from '@mui/material'
// Loads 2,225 modules, takes ~4.2s extra in dev
```
**Correct (imports only what you need):**
```tsx
import Check from 'lucide-react/dist/esm/icons/check'
import X from 'lucide-react/dist/esm/icons/x'
import Menu from 'lucide-react/dist/esm/icons/menu'
// Loads only 3 modules (~2KB vs ~1MB)
import Button from '@mui/material/Button'
import TextField from '@mui/material/TextField'
// Loads only what you use
```
**Alternative (Next.js 13.5+):**
```js
// next.config.js - use optimizePackageImports
module.exports = {
experimental: {
optimizePackageImports: ['lucide-react', '@mui/material']
}
}
// Then you can keep the ergonomic barrel imports:
import { Check, X, Menu } from 'lucide-react'
// Automatically transformed to direct imports at build time
```
Direct imports provide 15-70% faster dev boot, 28% faster builds, 40% faster cold starts, and significantly faster HMR.
Libraries commonly affected: `lucide-react`, `@mui/material`, `@mui/icons-material`, `@tabler/icons-react`, `react-icons`, `@headlessui/react`, `@radix-ui/react-*`, `lodash`, `ramda`, `date-fns`, `rxjs`, `react-use`.
Reference: [How we optimized package imports in Next.js](https://vercel.com/blog/how-we-optimized-package-imports-in-next-js)
© tech-leads-club · MIT · tech-leads-club/agent-skills