# gt: General Translation CLI tool: TypeScript 和 JavaScript
URL: https://generaltranslation.com/zh/docs/cli/reference/formats/ts-js-files.mdx
---

title: TypeScript 和 JavaScript
description: 使用 General Translation CLI 翻译 TypeScript 和 JavaScript 文件。TypeScript 和 JavaScript 文件格式的 API 参考。

---

CLI 支持翻译 TypeScript (`ts`) 和 JavaScript (`js`) 文件。源文件中的所有语法和格式都会在翻译后的文件中保留。

## 配置 [#config]

在 `files` 下添加一个 `ts` 或 `js` 条目，并提供一个包含 glob 模式的 `include` 数组。使用 `[locale]` 占位符，这样 CLI 就能找到源文件，并将翻译保存到正确的路径。

```json title="gt.config.json"
{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "ts": {
      "include": ["scripts/[locale]/**/*.ts"]
    }
  }
}
```

这会翻译 `scripts/en` 下的所有 TypeScript 文件，并将结果保存到 `scripts/fr` 和 `scripts/es`。对于 JavaScript 文件，请改用 `js` 键。有关所有文件键，请参阅[配置参考](/docs/cli/reference/config#files)。

## 更新静态数据导出 [#data-exports]

当更新后的 TypeScript 或 JavaScript 文件包含静态数据导出时，General Translation 会复用先前翻译中匹配的字符串，只翻译新增或变更的字符串。复用适用于已导出的变量，且其值仅包含字面量、数组和普通对象。包含展开语法、标识符、函数调用、模板字符串或 JSX 的导出会走标准翻译流程。

强制重新翻译和词汇表重新翻译会跳过这种增量复用。