0Pricing
Vue Academy · 강의

Vue 프로젝트의 TypeScript 설정

vite.config.ts, tsconfig.json, vue-tsc, SFC의 lang='ts' 설정과 IDE TypeScript 지원을 알아봅니다.

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

Vue 3에서 TypeScript 사용

Vue 3는 TypeScript로 다시 작성되었으므로 뛰어난 타입 지원을 제공합니다. 잘 구성된 프로젝트는 컴파일 시점에 버그를 찾아내고 .vue 파일에서 우수한 편집기 자동 완성을 지원합니다.

TS로 프로젝트 골격 구성

가장 쉬운 시작 방법은 create-vue를 사용하는 것입니다. 이 도구는 TypeScript를 추가할지 묻고, tsconfig.json, vue-tsc, 그리고 알맞은 도구를 설정해 줍니다.

npm create vue@latest
# select "Add TypeScript? Yes"

tsconfig.json 기초

tsconfig.json은 컴파일을 제어합니다. 버그를 찾아내는 데 가장 중요한 설정은 엄격 모드입니다.

{
  "compilerOptions": {
    "strict": true,
    "target": "ESNext",
    "module": "ESNext"
  }
}

엄격 모드가 중요한 이유

strict: true는 strictNullChecks, noImplicitAny 등을 활성화합니다. 따라서 null/undefined를 반드시 처리해야 하며, 타입이 지정되지 않은 값이 몰래 통과하는 것을 막습니다.

경로 별칭

@/ 별칭은 src 폴더에 매핑되므로 파일 깊이와 관계없이 가져오기를 깔끔하게 유지할 수 있습니다. tsconfig.json과 번들러 양쪽에서 설정하십시오.

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    }
  }
}

별칭 사용하기

이제 가져오기는 상대적인 ../../ 경로를 이어 붙이는 대신 프로젝트 루트에서 모듈을 참조합니다.

import Button from '@/components/Button.vue'
import { useAuth } from '@/composables/useAuth'

SFC에서 TypeScript 사용하기

단일 파일 컴포넌트 안에서 TypeScript를 사용하려면 스크립트 태그에 lang="ts"를 추가하십시오. <script setup>과 함께 사용하면 타입이 적용된 매크로를 사용할 수 있습니다.

<script setup lang="ts">
const count: number = 0
</script>

SFC 타입 검사

일반 tsc 컴파일러는 .vue 파일을 이해하지 못합니다. Vue는 템플릿과 스크립트를 함께 타입 검사하는 래퍼인 vue-tsc를 제공합니다.

vue-tsc --noEmit

검사 스크립트 추가하기

package.json에 스크립트를 추가하면 CI와 개발 환경에서 한 번의 명령으로 타입을 확인할 수 있습니다.

{
  "scripts": {
    "type-check": "vue-tsc --noEmit"
  }
}

Volar를 통한 편집기 지원

Volar(Vue - Official) VS Code 확장 프로그램은 .vue 파일 안에서 TypeScript 지능형 기능을 제공합니다. 여기에는 자동 완성, 정의로 이동, 템플릿 타입 오류가 포함됩니다. 충돌을 피하려면 기존 Vetur를 비활성화하십시오.

인계 모드

Volar는 인계 모드로 실행할 수 있습니다. 이 모드에서는 기본 제공 TS 확장 프로그램을 대체하여 .ts와 .vue 파일을 모두 처리합니다. 대규모 프로젝트에서 성능과 일관성이 향상됩니다.

빠른 확인

TypeScript 설정에 관한 지식을 테스트해 보십시오.

복습

Vue에서 TypeScript를 설정하는 방법을 배웠습니다.

  • 가장 강력한 검사를 사용하려면 tsconfig.json에서 엄격 모드를 활성화합니다.
  • @/* 경로 별칭을 src에 매핑합니다.
  • SFC 스크립트에 lang="ts"를 추가합니다.
  • vue-tsc --noEmit으로 타입을 검사하고 VS Code에서 Volar 확장 프로그램을 사용합니다.

자주 묻는 질문

“Vue 프로젝트의 TypeScript 설정” 강의는 무료인가요?

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

“Vue 프로젝트의 TypeScript 설정”에서 뭘 배우나요?

vite.config.ts, tsconfig.json, vue-tsc, SFC의 lang='ts' 설정과 IDE TypeScript 지원을 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

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

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

“Vue 프로젝트의 TypeScript 설정” 강의는 얼마나 걸리나요?

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

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

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

이 강의의 모든 강의

  1. Vue 프로젝트의 TypeScript 설정
  2. defineProps/defineEmits로 Props와 Emits 타입 지정
  3. 컴포저블과 Ref의 타입 지정
  4. 제네릭 Vue 컴포넌트
← Vue Academy(으)로 돌아가기