외부 공개 멤버
상수, 함수, 타입을 다른 파일에서 사용할 수 있도록 명시적으로 내보냅니다.
export function sum()
ES 모듈 연결 구조
모듈은 파일 사이의 의존성을 명시하고, TypeScript는 그 경로를 따라 값과 타입 정보를 함께 추적합니다.
필요한 멤버 가져오기
다른 파일이나 패키지에서 공개한 값을 현재 모듈에 연결합니다.
import { sum } from "./math"
파일 위치 기준
./와 ../로 현재 파일에서 목적 파일까지의 위치를 표현합니다.
../utils/date
긴 상대 경로 줄이기
baseUrl과 paths 설정으로 프로젝트 내부 경로를 읽기 좋게 만듭니다.
@/components/Button
값과 타입
type-only import가 필요한 경우 런타임 import와 구분합니다.
순환 의존
서로 가져오는 파일이 생기면 책임 분리를 다시 검토합니다.
확장자 처리
컴파일 대상과 실행 환경에 따라 경로 확장자 규칙이 달라질 수
있습니다.
모듈 시스템은 파일을 나누는 기술이 아니라 의존성 방향과 공개 API를 관리하는 구조입니다.