> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 语言与文案

使用四语言词典骨架覆盖应用界面、设置标签、邮件与通知事件。

## 安装与配置

在执行任何步骤之前，请阅读[开始之前](https://supastack.dev/zh/docs/web/before-you-start.md) 和[终端基础知识](https://supastack.dev/zh/docs/web/terminal-basics.md)。这些说明假设您在 VS Code 中打开了完整的 supastack monorepo；它的根 package.json 标记存储库根。在 pnpm 命令中，工作区包是应用程序或共享代码文件夹；在产品中，工作空间是团队的数据容器和安全边界。 corepack pnpm --filter ... 从 monorepo 选择一个包，同时从其根运行命令。如果您仅打开同步的移动或桌面文件夹，则它不包含 Web 后端、Docker 设置或根脚本：从此 monorepo 或可访问的托管服务器运行后端，并使用平台文件夹自己的脚本。环境变量是存储在本地 .env 文件或托管仪表板中的命名设置；更改后重新启动相关应用程序，并将服务器机密保留在 NEXT_PUBLIC_ 和 EXPO_PUBLIC_ 值之外。

1. 在 VS Code 中打开 packages/i18n/src/index.ts 查看支持的语言名称和语言环境帮助程序；在更改产品副本之前找到匹配的字典文件。

2. 为英语、德语、西班牙语和法语词典添加相同的新键和翻译。

3. 从存储库根目录运行 corepack pnpm test -- packages/i18n/src/index.test.ts 并使用 corepack pnpm --filter @supastack/web dev 启动 Web。预期：语言切换器更改可见文本，同时保留当前页面路径。

语言环境位于 @supastack/i18n 中，包括 SUPPORTED_LOCALES、LOCALE_COOKIE、resolveLocale、getDictionary 和 localePath。代理设置 x-supastack-locale 并处理规范的英语重定向； LanguageSwitcher 更新 cookie 并保留活动子路径。关键应用程序路由（/dashboard、/settings、/billing、/chat）直接在 /[locale] 前缀下与软 /{locale} 营销主页一起工作。

词典涵盖营销导航、设置部分标签、组织设置 chrome、事务邮件（邀请/OTP/magic-link/AI/计费）、通知首选项标签和应用内通知事件副本。

```
import { getDictionary, resolveLocale, LOCALE_COOKIE } from "@supastack/i18n";

const locale = resolveLocale([
  cookieStore.get(LOCALE_COOKIE)?.value,
  headers.get("x-supastack-locale"),
  headers.get("accept-language"),
]);
const copy = getDictionary(locale);
```


## 要复制的命令

按照注释查看命令在哪个文件夹中运行。如果标记了两个终端，请打开两个终端窗口，并在使用第二个命令时保持第一个命令运行。

```
corepack pnpm test -- packages/i18n/src/index.test.ts
corepack pnpm --filter @supastack/web dev
```


## 实现流程

将区域设置传递到服务器呈现的设置/组织页面，并传递到 notificationCopyForEvent / auth 邮件传递选项（如果可用）。将英语保留为 DEFAULT_LOCALE，并避免在字典键之外发明营销声明。

事务性邮件与营销触达保持分离。先把词典扩充完整，再考虑把每个营销路由套进 [locale] 之下。


## 验证与排障

如果某个短语出现英语，请检查该键是否存在于所有四个词典中，以及该页面是否要求相同的键。如果切换语言返回主页，请在构建语言环境链接时保留当前路径。将电子邮件副本保留在交易电子邮件路径上；不要将其重新用作批量外展。

运行 packages/i18n Vitest、代理测试和 locale-app-routes 测试。当区域设置前缀为 de/es/fr 时，抽查 / 上的 LanguageSwitcher 和本地化的 Settings/org/dashboard/billing/chat 标题。


## 下一篇

[撰写博客文章](https://supastack.dev/zh/docs/web/blog-content.md)