# gt: General Translation CLI tool: 保存本地修改
URL: https://generaltranslation.com/zh/docs/cli/save-local.mdx
---
title: 保存本地修改
description: 如何保存对本地翻译文件的修改
---

## 用法

```bash
npx gt save-local
```

<Callout type="info">
  此命令需要 API 密钥。请在
  [平台](https://generaltranslation.com/dashboard)
  上获取。
</Callout>


## 概述

`gt save-local` 命令会将你对翻译文件所做的本地修改保存回 General Translation 平台。具体过程如下：

1. 从 `gt.config.json` 读取已配置的文件
2. 解析当前 git 分支信息
3. 将本地翻译文件与最新下载的服务端版本进行比较
4. 计算你所做更改的差异
5. 将这些差异提交到 General Translation 平台

此命令**不会将任何新翻译加入队列**。它只会将你的本地修改同步回平台。

<Callout type="info">
  当你或你的团队在本地手动编辑了翻译文件，并希望这些更改同步到平台时，这个命令就很有用。例如，译者直接在 JSON 文件中做了修正。
</Callout>

## 工作原理

CLI 会在锁文件中记录哪些翻译已下载。运行 `save-local` 时，它会：

1. 通过比较内容哈希，识别自上次下载以来发生变更的文件
2. 获取这些文件在服务器上的原始内容
3. 生成服务器版本与你本地版本之间的统一差异
4. 将这些差异提交到平台

只有实际发生变更的文件才会被处理。

***

## 标志

| 参数             | 说明                           | 类型       | 可选     | 默认值                |
| -------------- | ---------------------------- | -------- | ------ | ------------------ |
| `--api-key`    | General Translation 的 API 密钥 | `string` | `true` |                    |
| `--project-id` | General Translation 项目 ID    | `string` | `true` |                    |
| `-c, --config` | GT 配置文件路径                    | `string` | `true` | `"gt.config.json"` |
| `--publish`    | 将翻译发布到 CDN                   | `flag`   | `true` | `false`            |

如果你已通过环境变量或在 `gt.config.json` 中配置了这些参数，则这些参数都可以省略。

<Callout type="warn">
  不要将 API 密钥添加到 `gt.config.json` 文件中！应改为将其设置为
  环境变量。设置后，CLI 会自动读取 `GT_API_KEY`。
</Callout>

## 相关命令

* [`gt translate`](/docs/cli/translate) - 翻译项目并下载译文
* [`gt translate --save-local`](/docs/cli/translate) - 翻译前先保存本地修改 (合并执行这两项操作)