Barrel File

Barrel 파일 (Barrel File) 이란 여러 모듈의 export를 한 곳에 모아 re-export하는 index.ts 파일.

목적

• import 경로를 단순화
• 모듈의 내부 구조를 캡슐화

예시

Barrel 없이:

import i18n from '@/i18n/config';
import {useTranslation} from 'react-i18next';

Barrel 사용:

import i18n, {useTranslation} from '@/i18n';

주의사항

• Tree-shaking 영향: export *는 번들러가 사용하지 않는 코드를 제거하기 어렵게 만들 수 있음.
• 순환 참조: barrel 파일끼리 서로 참조하면 순환 의존성 발생 가능
• JSDoc 불필요: re-export만 하는 파일에는 별도 문서화가 불필요

See also

• javascript
• typescript