For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /zh/docs/web/i18n.md (or send Accept: text/markdown).

语言与文案

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

询问本指南

安装与配置

在执行任何步骤之前，请阅读开始之前和终端基础知识。这些说明假设您在 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 标题。