# gt: General Translation CLI tool: TypeScript 和 JavaScript
URL: https://generaltranslation.com/zh/docs/cli/reference/formats/ts-js-files.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 使用 General Translation CLI 翻译 TypeScript 和 JavaScript 文件。TypeScript 和 JavaScript 文件格式的 API 参考。

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

## 概述 [#overview]

| 主题                      | 描述                  |
| ----------------------- | ------------------- |
| [配置](#config)           | 选择源文件和翻译输出路径。       |
| [静态数据导出](#data-exports) | 在符合条件的导出中复用未变更的字符串。 |

## 配置 [#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 会复用先前翻译中匹配的字符串，只翻译新增或变更的字符串。当区块中的每个已导出变量仅包含静态字符串、数字、bigint、布尔值或 `null` 字面量、数组和普通对象时，便会应用复用。支持 TypeScript 断言包装器。

包含展开语法、标识符、函数调用、模板字符串、JSX 或计算对象键的导出会走标准翻译流程。运行 [`gt translate --force`](/docs/cli/reference/commands/translate) 或应用词汇表翻译也会跳过这种增量复用。

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.