배럴 파일 사용을 중단해 주세요

파일 구조의 일관성 유지

프론트엔드 개발자들 사이에서 파일을 "올바르게" 조직하는 방법은 논쟁의 여지가 많은 주제입니다. "느낌이 맞을 때까지 파일을 이동하라"는 밈이 널리 퍼져 있지만, 이는 팀 단위로 작업할 때 효과적이지 않을 수 있습니다. 팀 내에서는 각자 다른 방식을 선호할 수 있기 때문에, 주관적인 조언은 전문적인 환경에서 크게 도움이 되지 않습니다.

팀 일관성의 중요성

대부분의 개발자들은 프로젝트가 이미 사용하는 구조에 맞춰 조정하는 것을 선호합니다. 개인적인 선호와 상관없이 이해하기 쉬운 일관된 코드베이스를 유지하는 것이 중요합니다. 이를 위해 일관된 파일명 규칙을 적용하고, 가능한 한 규칙을 고정적으로 적용하여 불필요한 논의를 피하는 것이 좋습니다. 예를 들어, unicorn/filename-case 규칙을 사용하여 파일 이름의 케이스를 통일할 수 있습니다.

배럴 파일 사용 중단의 필요성

배럴 파일은 다른 파일들로부터 내용을 재수출하는 파일로, 주로 index.js나 index.ts라는 이름을 사용합니다. 이는 디렉토리의 내부 구조를 외부에 숨기고, 임포트 시 단일 인터페이스를 제공하여 코드의 가독성을 높일 수 있습니다. 예를 들어, 개별 파일을 임포트하는 대신 배럴 파일을 통해 한 번에 임포트할 수 있습니다. 그러나 배럴 파일을 사용하면 순환 참조와 같은 문제가 발생할 수 있어, 사용을 자제하는 것이 좋습니다.

함께 읽으면 좋은 참고 자료

• How to Organize Your Files for a React Project
• Effective JavaScript Patterns
• Clean Code: A Handbook of Agile Software Craftsmanship

[출처] Please Stop Using Barrel Files