如何创建我的第一个项目？

一个项目保存着某个应用或站点的键、语言和设置。创建只需一分钟；真正需要想清楚的是源语言，以及你的密钥最终放在哪里。

创建项目

1. 在 app.better-i18n.com 登录
2. 点击 New Project
3. 命名——这个名字会成为项目的 slug，请保持简短
4. 选择源语言：也就是你的代码所使用的语言
5. 添加你想翻译成的语言
6. 点击 Create

源语言是唯一需要斟酌的选择。 所有译文都由它产出，每个键的原文也都存放在它之下。之后可以在 Settings → CDN 中修改，但它是其余一切的参照点，所以请从你实际书写的语言开始。

目标语言改起来很轻松——随时在 Languages 页面增删。

你的项目标识符

每个项目都以 org/project 的形式寻址，例如 acme/dashboard。你会把它写进 SDK 配置、CLI 配置以及每一次 API 调用。

创建 API 密钥 #

Settings → API Keys → Create Key。

起一个半年后你还认得出的名字（“CI”“local dev”），并选择有效期：3 个月、6 个月、1 年，或永不过期。列表会显示每个密钥的剩余时间，并在距到期不足一个月时提醒你——一个在 CI 里悄无声息失效的密钥，会毁掉一个下午。

密钥只显示一次。 出现时立刻复制；之后无法再次查看，只能替换。

哪个密钥用在哪里

CDN 密钥只能获取已发布的译文，而那本就是访客会下载的公开数据。API 密钥能修改你的项目，因此它属于服务端环境变量或 CI 机密——绝不能出现在客户端代码里，也绝不能提交进仓库。

如果私密密钥确实泄露到了公开位置：在 API Keys 页面吊销它并新建一个。吊销立即生效。

让你的应用指向它

# .env
BETTER_I18N_PROJECT=acme/dashboard
BETTER_I18N_API_KEY=...

// 具体调用方式取决于你的框架——请参阅 SDK 指南
const i18n = createI18n({
  project: "acme/dashboard",
  defaultLocale: "en",
});

接下来

• 如何添加我的第一批翻译键？
• 如何配置 CLI 并扫描我的项目？
• 如何发布译文，让我的应用用上它们？