---
createdAt: 2025-09-22
updatedAt: 2025-09-22
title: New Intlayer v6 - 새로운 기능은 무엇인가요?
description: Intlayer v6의 새로운 기능을 알아보세요. 성능, 개발자 경험, 그리고 국제화 워크플로우를 향상시키는 주요 기능들이 포함되어 있습니다.
keywords:
  - Intlayer
  - 현지화
  - 개발
  - 성능
  - 개발자 경험
  - 기능
  - React
  - Next.js
  - JavaScript
  - TypeScript
slugs:
  - doc
  - releases
  - v6
---

# New Intlayer v6 - 새로운 기능은 무엇인가요?

Intlayer v6에 오신 것을 환영합니다! 이번 릴리스는 성능, 개발자 경험, 그리고 안정성에 중점을 두고 있습니다. 아래는 주요 내용과 마이그레이션 노트, 복사하여 붙여넣을 수 있는 예제들입니다.

## 주요 내용

- 누락된 번역을 감지하는 새로운 명령어: `npx intlayer content test`
- 누락된 번역을 자동 생성하는 새로운 전역 `autoFill` 옵션
- Fill 명령어는 기본적으로 기존 번역을 건너뜁니다: `npx intlayer fill`
- VS Code 확장: 새로운 Intlayer 활동 표시줄(검색 및 사전), 툴바/컨텍스트 액션, 자동 표시, Fill/Test 명령어
- 프로미스 병렬 처리로 10배 빠른 빌드 속도
- 앱 시작 시 재요청을 방지하는 원격 사전 캐싱
- 향상된 로깅: 동작을 검사하려면 `log.mode: 'verbose'` 설정
- 사전 문제로 인한 앱 충돌 방지를 위한 강화된 검증
- `build.importMode = 'live'` 및 `pnpm intlayer live`를 사용한 CMS 실시간 업데이트
- 수정 사항: Vue.js 통합, Lynx 어댑터, Windows용 비주얼 에디터

---

## 새로운 기능: 누락된 번역 테스트

프로젝트를 빠르게 감사하여 누락된 키/로케일을 찾습니다.

```bash
npx intlayer content test
```

출력:

```bash
pnpm intlayer content test
누락된 번역:
 - blog-data       - 일본어 (ja), 한국어 (ko), 중국어 (zh), 독일어 (de), 이탈리아어 (it) - src/components/BlogPage/blogData.content.ts
 - demo-page       - 프랑스어 (fr), 이탈리아어 (it)                                         - src/components/DemoPage/demo.content.ts
 - locale-switcher - 이탈리아어 (it), 포르투갈어 (pt)                                       - src/components/LocaleSwitcher/localeSwitcher.content.ts
로케일: 영어 (en), 러시아어 (ru), 일본어 (ja), 프랑스어 (fr), 한국어 (ko), 중국어 (zh), 스페인어 (es), 독일어 (de), 아랍어 (ar), 이탈리아어 (it), 영국 영어 (en-GB), 포르투갈어 (pt), 힌디어 (hi)
필수 로케일: 영어 (en)
누락된 로케일: 일본어 (ja), 한국어 (ko), 중국어 (zh), 독일어 (de), 이탈리아어 (it), 프랑스어 (fr), 포르투갈어 (pt)
필수 누락 로케일: -
총 누락 로케일 수: 7
총 필수 누락 로케일 수: 0
```

CLI 문서에서 더 많은 옵션을 확인하세요: [CLI 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md) → "누락된 번역 테스트". 또한 [테스팅](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/testing.md) 가이드를 참고하세요.

---

## 새 기능: 누락된 번역을 완성하는 글로벌 autoFill

이제 전역적으로 auto-fill을 활성화하여 누락된 번역이 있는 모든 사전을 자동으로 완성할 수 있습니다.

```ts fileName="intlayer.config.ts"
import { type IntlayerConfig, Locales } from "intlayer";

const config: IntlayerConfig = {
  internationalization: {
    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
    defaultLocale: Locales.ENGLISH,
    requiredLocales: [Locales.ENGLISH, Locales.FRENCH],
  },
  content: {
    // 모든 사전의 누락된 번역을 자동 생성합니다
    autoFill: "./{{fileName}}.content.ts",
    //
    // autoFill: "/messages/{{locale}}/{{key}}/{{fileName}}.content.json",
    //
    // autoFill: true, // "./{{fileName}}.content.json"을 사용하는 것처럼 모든 사전에 대해 누락된 번역을 자동 생성합니다
    //
    // autoFill: {
    //   en: "./{{fileName}}.en.content.json",
    //   fr: "./{{fileName}}.fr.content.json",
    //   es: "./{{fileName}}.es.content.json",
    // },
  },
};

export default config;
```

콘텐츠 파일 내 `autoFill` 필드를 사용하여 사전별로 세부 조정을 계속할 수 있습니다. 전체 참조는 `doc/autoFill` 및 `doc/dictionary/content_file`에서 확인하세요.

---

## fill 명령어: 더 안전한 기본값

fill 명령어는 이제 기본적으로 누락된 번역만 채우고 기존 콘텐츠는 건너뜁니다.

```bash
npx intlayer fill
```

```bash
처리할 사전 키: access-key-creation-form-schema, doc-search-metadata, doc-search-page
  - [access-key-creation-form-schema]      사전에 파일 경로가 없습니다. 건너뜁니다.
  - [access-key-creation-form-schema]      콘텐츠 선언 처리 중: src/components/Dashboard/ProjectForm/AccessKey/useAccessKeyCreationFormSchema.content.ts
  - [access-key-creation-form-schema]      채울 로케일이 없습니다 - 사전 건너뜁니다
  - [doc-search-metadata]                  사전 파일 경로가 없습니다. 건너뜁니다.
  - [doc-search-metadata]                  콘텐츠 선언 처리 중: src/app/[locale]/(docs)/doc/search/metadata.content.ts
  - [doc-search-metadata]                  채울 로케일이 없습니다 - 사전 건너뜁니다.
  - [doc-search-page]                      사전 파일 경로가 없습니다. 건너뜁니다.
  - [doc-search-page]                      콘텐츠 선언 처리 중: src/app/[locale]/(docs)/doc/search/page.content.ts
  - [doc-search-page]                     [러시아어 (ru)]                   영어(en)에서 러시아어(ru)로 사전 번역 준비 중
[intlayer]  src/app/[locale]/(docs)/doc/search/page.content.ts에 Prettier 포맷팅 적용 완료
  - [doc-search-page]                      Content declaration written to src/app/[locale]/(docs)/doc/search/page.content.ts
```

CI 예제는 [CI/CD](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/CI_CD.md)에서 확인할 수 있습니다.

---

## 업데이트된 VS Code 확장 기능

이 확장 기능은 이제 Activity Bar에 전용 Intlayer 탭을 포함하며 여러 워크플로우 개선 사항이 적용되었습니다:

- 두 가지 뷰가 있는 Intlayer Activity Bar:
  - 라이브 사전/콘텐츠 검색을 위한 검색 웹뷰 (`intlayer.searchBar`)
  - 환경, 사전, 기여 파일을 나열하는 사전 트리 (`intlayer.dictionaries`)
- 사전 뷰의 툴바: 빌드, 풀, 푸시, 채우기, 새로 고침, 테스트, 사전 파일 생성
- 컨텍스트 메뉴: 사전에서 풀/푸시; 파일에서 채우기
- 자동 표시: 현재 편집기 파일이 해당되는 경우 사전 트리에서 강조 표시됩니다.
- 명령 팔레트에서 사용할 수 있는 새로운 명령: 사전 채우기(Fill Dictionaries) 및 사전 테스트(Test Dictionaries)

자세한 내용은 [공식 VS Code 확장](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md) 문서를 참조하세요.

---

## 성능: 10배 빠름

- 로컬 및 원격 사전의 병렬 해석
- 원격 사전은 앱 시작 시 재요청을 방지하기 위해 캐시됨

```bash
npx intlayer build
```

출력:

```bash
[intlayer]  Intlayer 준비 중 (v6.0.1)
[intlayer]  사전:
[intlayer]  ✓ 로컬 콘텐츠: 163/163
[intlayer]  ✓ 원격 콘텐츠: 100/100
[intlayer]   - access-key-creation-form             [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - access-key-creation-form-schema      [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - access-key-form                      [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - ai-ab-testing-section                                 [distant: ✔ 가져옴]
[intlayer]   - application-not-running-view         [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - application-template-message         [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - aside-navigation                     [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - ask-reset-password                   [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - ask-reset-password-schema            [local: ✔ 빌드됨] [distant: ✔ 가져옴]
[intlayer]   - 자동완성-섹션               [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
[intlayer]   - 사용가능-기술-섹션             [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
[intlayer]   - 블로그-데이터                            [로컬: ✔ 빌드됨]
[intlayer]   - 블로그-메타데이터                        [로컬: ✔ 빌드됨]
[intlayer]   - 블로그-네비게이션-리스트                        [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
[intlayer]   - 블로그-페이지                                             [원격: ✔ 가져옴]
[intlayer]   - 블로그-검색-메타데이터                 [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
[intlayer]   - 블로그-검색-페이지                     [로컬: ✔ 빌드됨] [원격: ✔ 가져옴]
...
[intlayer]  콘텐츠 로드 완료  (총: 8401ms - 로컬: 4050ms - 원격: 4222ms)
```

---

## 로깅 개선사항

빌드 및 런타임 변환 중에 발생하는 상황에 대해 더 자세한 정보를 제공하도록 로깅 시스템이 개선되었습니다.

> 빌드 및 런타임 변환 중에 발생하는 상황을 더 잘 이해하려면 자세한 로그를 활성화하세요.

```ts fileName="intlayer.config.ts"
export default {
  log: {
    mode: "verbose", // 옵션: "default" | "verbose" | "disabled"
  },
};
```

모든 로깅 옵션은 [설정](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)에서 확인하세요.

---

## 강화된 검증

사전 처리 시 더 강력한 검증이 수행됩니다. 사전 처리에 실패할 경우, Intlayer는 애플리케이션이 중단되지 않도록 하며, 실행 가능한 오류를 표시합니다.

---

## CMS와 함께하는 라이브 업데이트 (프로덕션 안전)

프로덕션 환경에서 애플리케이션을 다시 빌드하지 않고 라이브 콘텐츠 업데이트(예: 편집 업데이트)를 제공합니다.

1. 라이브 임포트 모드를 활성화하세요:

```ts fileName="intlayer.config.ts"
import { type IntlayerConfig } from "intlayer";

const config: IntlayerConfig = {
  build: {
    importMode: "live", // "static" | "dynamic" | "live"
  },
  editor: {
    liveSync: true, // 서버 측 라이브 동기화 활성화
  },
};

export default config;
```

2. 앱을 실행하고 라이브 프로세스를 병행하세요:

```bash
npx intlayer live --process 'vite preview'
```

참고:

- 라이브 모드 사용으로 표시된 사전만 라이브로 가져옵니다. 나머지는 성능 최적화를 위해 처리됩니다.
- 라이브 API에 접근할 수 없으면 동적 임포트로 대체됩니다.

[CMS 및 라이브 동기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)와 [구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)을 참조하여 완전한 안내를 확인하세요.

---

## 마이그레이션 노트

- 제거됨: `dictionaryOutput` (이전에는 `i18next` 또는 `next-intl`). 향후 버전에서 플러그형 어댑터로 다시 제공될 예정입니다. 구성에서 해당 필드를 제거하세요.
- 관련 제거: `i18nextResourcesDir` (`doc/configuration` 변경 로그 참조).
- 대규모 누락 번역 생성을 위해 새로운 전역 옵션 `content.autoFill` 사용을 권장합니다.
- 누락된 번역에 대해 PR을 검증하려면 `npx intlayer content test`를 사용하세요.
- 자세한 진단을 위해 `log.mode = 'verbose'`로 설정하세요.

---

## 수정 사항

- Vue.js 통합 안정성 향상
- Lynx 어댑터 개선
- Windows에서의 비주얼 에디터

---

## 유용한 링크

- [CLI 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_cli.md)
- [자동 채우기](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/autoFill.md)
- [구성](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/configuration.md)
- [콘텐츠 파일 참조](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/dictionary/content_file.md)
- [공식 VS 코드 확장](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/vs_code_extension.md)
- [CMS 및 라이브 동기화](https://github.com/aymericzip/intlayer/blob/main/docs/docs/ko/intlayer_CMS.md)
