---
title: 项目配置
description: 创建应用配置并接入 Vite 插件。
order: 10
toc:
  - id: configuration
    title: 配置文件
  - id: catalog-sources
    title: 词典来源
  - id: vite-plugin
    title: Vite 插件
---

## 配置文件 {#configuration}

在使用方应用中创建 `i18n.config.json`：

```json
{
  "sourceLocale": "en-US",
  "locales": ["en-US", "zh-Hans"],
  "catalogPath": "src/locales/{locale}/messages",
  "catalogSources": ["@workspace/ui/locales/{locale}"],
  "include": ["src", "../../packages/ui/src"],
  "exclude": ["**/*.test.{ts,tsx}"]
}
```

该文件是应用唯一的持久国际化配置。CLI 命令只为子进程创建临时 Lingui 配置。

工作区只提供简体中文（`zh-Hans`）和美式英语（`en-US`）。应用词典和包词典来源应使用相同的语言键。

## 词典来源 {#catalog-sources}

词典来源按从左到右的顺序合并，应用词典始终位于最后。将可复用包词典放在前面，使产品特有翻译可以覆盖它们。

## Vite 插件 {#vite-plugin}

```ts
import { i18n } from "@workspace/i18n/vite"
import { defineConfig } from "vite"

export default defineConfig({
  plugins: [i18n()],
})
```

插件会提供开发词典 API，并通过 `@workspace/i18n/catalogs` 暴露生成的加载器。