0Pricing
Vue Academy · 강의

확장 가능한 폴더 구조

유지 관리가 쉽도록 대규모 Vue 프로젝트를 구성합니다.

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

구조가 중요합니다

Vue 앱이 몇 개의 파일을 넘어 성장하면, 파일을 어떻게 구성하느냐에 따라 탐색과 유지 관리, 새로운 개발자의 적응이 얼마나 쉬운지가 결정됩니다. 좋은 구조는 확장되지만, 무질서한 구조는 모두의 작업을 느리게 합니다.

유형 중심 구성

유형 중심 방식은 파일을 종류별로 그룹화합니다. 모든 컴포넌트는 함께, 모든 뷰는 함께, 모든 스토어는 함께 배치합니다. 단순하며 소규모에서 중간 규모 앱에 잘 맞습니다.

src/
  components/
  views/
  stores/
  composables/
  router/

기능 중심 구성

기능 중심 방식은 파일을 해당 파일이 속한 기능별로 그룹화합니다. 인증 기능에 필요한 모든 것이 하나의 폴더에 있으므로 대규모 앱을 더 쉽게 파악할 수 있습니다.

src/
  features/
    auth/
      LoginView.vue
      useAuth.js
      authStore.js
    cart/
      CartView.vue
      cartStore.js

방식 선택하기

유형 중심 방식은 규모가 작은 앱에 적합합니다. 앱이 성장하고 기능이 늘어나면 기능 중심 방식이 관련 코드를 함께 모아 폴더 사이를 오가는 일을 줄여 줍니다. 많은 팀이 유형 중심으로 시작한 뒤 규모가 커지면서 기능 중심으로 옮겨 갑니다.

뷰와 컴포넌트 분리하기

뷰(페이지 수준의 라우팅된 컴포넌트)와 컴포넌트(재사용 가능한 구성 요소)를 구분하세요. 이렇게 분리하면 어떤 부분이 라우팅 대상이고 어떤 부분이 공유되는지 명확해집니다.

views/      // routed pages: HomeView.vue, AboutView.vue
components/ // reusable: BaseButton.vue, UserCard.vue

컴포저블 구성하기

재사용 가능한 Composition API 로직은 composables 폴더에 보관하세요. 이름에 use 접두사를 사용하면 한눈에 용도를 알 수 있습니다.

composables/
  useAuth.js
  useFetch.js
  useLocalStorage.js

스토어 구성하기

전역 상태 스토어는 stores 폴더에 두고, 도메인마다 파일 하나를 배정하세요. 이렇게 하면 상태 관리를 쉽게 찾을 수 있고 모듈화할 수 있습니다.

stores/
  user.js
  cart.js
  settings.js

이름 지정 규칙

일관성을 유지하면 불필요한 수고가 줄어듭니다. 컴포넌트 파일에는 PascalCase를 사용하고, 기본 컴포넌트에는 Base를 접두사로 붙이며, HTML 요소와 충돌하지 않도록 여러 단어로 된 이름을 사용하세요.

// components
BaseButton.vue
BaseInput.vue
UserProfileCard.vue

// composables
useAuth.js

배럴 내보내기

배럴은 폴더의 내용을 다시 내보내는 index.js 파일입니다. 따라서 사용하는 쪽에서는 여러 경로가 아닌 하나의 경로에서 가져올 수 있습니다.

// composables/index.js
export { useAuth } from "./useAuth"
export { useFetch } from "./useFetch"

배럴에서 가져오기

배럴을 사용하면 여러 import를 깔끔한 한 줄로 합칠 수 있어 가독성이 좋아집니다.

import { useAuth, useFetch } from "@/composables"

일관성 유지하기

어떤 구조를 선택하든 일관되게 적용하고 프로젝트 README에 문서화하세요. 가장 좋은 구조는 팀 전체가 이해하고 따르는 구조입니다. 앱이 성장하면 기능 중심 구조로 리팩터링하세요.

간단히 확인하기

폴더 구조에 대한 이해도를 확인해 보세요.

복습

규모가 작은 앱에서는 유형별로 구성하고, 규모가 커지면 기능별로 구성하세요. 라우팅된 뷰와 재사용 가능한 컴포넌트를 분리하고, 컴포저블과 스토어는 각각의 폴더에 보관하며, 일관된 이름 지정 규칙을 따르고, 깔끔한 가져오기를 위해 배럴 내보내기를 사용하세요. 팀을 위해 문서화된 일관성이야말로 구조를 진정으로 확장 가능하게 만듭니다.

자주 묻는 질문

“확장 가능한 폴더 구조” 강의는 무료인가요?

네 — “확장 가능한 폴더 구조” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 3개의 강의가 포함되어 있습니다.

“확장 가능한 폴더 구조”에서 뭘 배우나요?

유지 관리가 쉽도록 대규모 Vue 프로젝트를 구성합니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“확장 가능한 폴더 구조” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. 믹스인과 사용자 지정 디렉티브
  2. 플러그인 개발
  3. 확장 가능한 폴더 구조
← Vue Academy(으)로 돌아가기