tsconfig.json

Nuxt가 프로젝트의 다양한 부분에서 TypeScript 구성을 어떻게 관리하는지 알아보세요.

Nuxt는 프로젝트를 위해 권장되는 기본 TypeScript 구성, 자동 임포트, API 라우트 타입, 경로 별칭 등을 포함하는 여러 TypeScript 구성 파일(.nuxt/tsconfig.app.json, .nuxt/tsconfig.server.json, .nuxt/tsconfig.node.json 및 .nuxt/tsconfig.shared.json)을 자동으로 생성합니다.

Nuxt 프로젝트의 루트에는 다음과 같은 tsconfig.json 파일이 포함되어야 합니다:

tsconfig.json
{
  "files": [],
  "references": [
    {
      "path": "./.nuxt/tsconfig.app.json"
    },
    {
      "path": "./.nuxt/tsconfig.server.json"
    },
    {
      "path": "./.nuxt/tsconfig.shared.json"
    },
    {
      "path": "./.nuxt/tsconfig.node.json"
    }
  ]
}
이 파일의 내용을 직접 수정하는 것은 권장하지 않습니다. 그렇게 하면 Nuxt나 다른 모듈이 의존하는 중요한 설정이 덮어써질 수 있습니다. 대신 nuxt.config.ts를 통해 확장하세요.
Nuxt 프로젝트의 서로 다른 타입 컨텍스트에 대해 여기에서 더 알아보세요.

TypeScript 구성 확장하기

nuxt.config.ts 파일에서 각 컨텍스트(app, shared, node, server)에 대해 Nuxt 프로젝트의 TypeScript 구성을 커스터마이즈할 수 있습니다.

nuxt.config.ts
export default defineNuxtConfig({
  typescript: {
    // tsconfig.app.json 커스터마이즈
    tsConfig: {
      // ...
    },
    // tsconfig.shared.json 커스터마이즈
    sharedTsConfig: {
      // ...
    },
    // tsconfig.node.json 커스터마이즈
    nodeTsConfig: {
      // ...
    },
  },
  nitro: {
    typescript: {
      // tsconfig.server.json 커스터마이즈
      tsConfig: {
        // ...
      },
    },
  },
})