0Pricing
JavaScript Academy · 강의

Node와 브라우저 번들러의 모듈 해석

가져오기가 해석되는 방식을 배웁니다. 상대 지정자와 단순 지정자, 파일 확장자(.js/.mjs/.cjs), index 파일, 간단한 패키지 진입점을 다룹니다.

Node와 브라우저 번들러의 모듈 해석은(는) CoddyKit의 무료 JavaScript Academy 강의입니다. 이것은 3개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 JavaScript Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. JavaScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

큰 그림

목표: 가져오기 경로가 어떻게 해석되는지 이해합니다.

  • 상대 지정자와 비수식 지정자
  • 명시적인 .js 사용(안전한 기본값)
  • 폴더의 index.js
  • 패키지 진입점(main/exports, 간단히)
Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 1

상대 경로와 비수식 경로

상대 가져오기는 ./ 또는 ../으로 시작합니다. 비수식 가져오기는 설치된 패키지를 가리킵니다.

// Relative path imports start with ./ or ../
// Bare specifiers refer to packages installed (e.g., "lodash")
const examples = [
  "import { sum } from \\"./math.js\\";   // relative, file nearby",
  "import leftPad from \\"left-pad\\";   // bare, from node_modules",
  "import thing from \\"../lib/thing.js\\"; // parent folder"
];

console.log("specifiers:");
for (const line of examples) console.log(line);
Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 2

확장자가 중요합니다

해석 오류를 피하려면 ESM에서 .js 확장자를 추가합니다. .mjs 또는 .cjs도 볼 수 있습니다.

// Include file extensions for ESM (safe beginner habit)
const extTips = [
  "Good (ESM): import util from \\"./util.js\\"",
  "Also seen: .mjs for ESM files, .cjs for CJS files",
  "Avoid: import \\"./util\\" (may fail in Node/browsers)"
];

console.log("extensions:");
for (const t of extTips) console.log(t);
Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 3

폴더와 index.js

폴더는 index.js를 노출하는 경우가 많습니다. 명시적으로 .../index.js를 작성하면 초보자가 이해하기 쉽습니다.

// If you import a folder, many setups look for index.js inside it
const folderExample = [
  "my-lib/",
  "  index.js",
  "  helpers/",
  "    index.js"
];

for (const l of folderExample) console.log(l);

// Typical imports
const dirImports = [
  "import main from \\"./my-lib/index.js\\";",
  "import alsoMain from \\"./my-lib/\\";        // some setups resolve to index.js",
  "import helper from \\"./my-lib/helpers/index.js\\";"
];

console.log("imports:");
for (const l of dirImports) console.log(l);
Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 4

패키지 진입점

패키지는 main/exports를 통해 진입점을 노출합니다. 비수식 가져오기는 ESM 또는 CJS에 맞는 파일을 선택합니다.

// Installed packages declare entry points in package.json
const pkgJson = [
  "{",
  "  \\"name\\": \\"tiny-lib\\",",
  "  \\"main\\": \\"dist/cjs/index.cjs\\",",
  "  \\"exports\\": {",
  "    \\".\\": { \\"import\\": \\"./dist/esm/index.js\\", \\"require\\": \\"./dist/cjs/index.cjs\\" }",
  "  }",
  "}"
];

console.log("package.json entry (example):");
for (const l of pkgJson) console.log(l);

// Importing a bare specifier will use these fields
console.log("import tiny-lib     -> resolves to ESM or CJS entry depending on environment");
Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 5

팁과 주의할 점

팁:

  • 로컬 파일에는 .js가 포함된 상대 경로를 우선 사용합니다.
  • 설치된 패키지에만 비수식 가져오기를 사용합니다.
  • 모호함을 피하려면 index.js를 명시합니다.
  • 브라우저에서는 가져오기 경로가 유효한 URL이어야 합니다(대개 확장자 포함).
Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 6

해석 기초 퀴즈

빠른 확인: 안전한 로컬 가져오기 경로입니다.

Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 7

복습

복습: 로컬 파일 → ./file.js. 패키지 → 비수식 이름. 폴더는 대개 index.js로 해석됩니다. 이러한 규칙을 알면 가져오기를 단순하고 예측 가능하게 유지할 수 있습니다.

Node와 브라우저 번들러의 모듈 해석 — 일러스트레이션 8

자주 묻는 질문

“Node와 브라우저 번들러의 모듈 해석” 강의는 무료인가요?

네 — “Node와 브라우저 번들러의 모듈 해석” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 JavaScript Academy 강의 전체를 잠금 해제할 수 있습니다. JavaScript Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

“Node와 브라우저 번들러의 모듈 해석”에서 뭘 배우나요?

가져오기가 해석되는 방식을 배웁니다. 상대 지정자와 단순 지정자, 파일 확장자(.js/.mjs/.cjs), index 파일, 간단한 패키지 진입점을 다룹니다. 브라우저에서 직접 실행하는 실습 코드로 JavaScript Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

JavaScript Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 JavaScript Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 3개 중 3번째 강의입니다.

“Node와 브라우저 번들러의 모듈 해석” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 JavaScript Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 JavaScript Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. ESM 기초 — import/export, 기본 내보내기와 이름 있는 내보내기
  2. CommonJS 기초 — require/module.exports와 exports
  3. Node와 브라우저 번들러의 모듈 해석
← JavaScript Academy(으)로 돌아가기