什么是Translate CLI
translate CLI 是一个专为开发者设计的命令行翻译工具，支持多种输入方式和翻译服务提供商。它允许用户直接在终端中对文本、标准输入、单个文件或多个文件进行翻译操作，并兼容 `.xcstrings` 格式的本地化资源文件。该工具的一大优势在于其灵活的配置系统，通过 TOML 格式的配置文件可持久化保存默认设置、API 端点及自定义提示词模板，极大提升了重复使用场景下的效率。无论是快速翻译一句话还是批量处理整个项目的国际化资源文件，translate CLI 都能提供简洁而强大的命令行接口。 该工具不仅支持主流商业 API（如 OpenAI、Anthropic、DeepL），还兼容自托管的 Ollama 模型以及任意 OpenAI 兼容的推理接口。这意味着用户既可以使用云端大语言模型完成高质量翻译，也能在本地部署私有模型以保护数据隐私。同时，translate CLI 提供了丰富的选项控制输出行为，包括是否覆盖原文件、重命名后缀、启用流式输出等，满足不同工作流需求。此外，它还内置了预设系统和模板机制，允许用户定义标准化的翻译指令，减少每次输入的重复劳动。 对于需要自动化或集成到 CI/CD 流程中的团队而言，translate CLI 提供了 dry-run、并行任务处理和错误验证等功能，确保翻译过程的可控性与可靠性。整体来看，它是一个高度可定制、跨平台和面向专业用户的命令行翻译解决方案，尤其适合从事多语言软件开发、文档维护或内容本地化的技术人员使用。
核心功能特点
- 支持文本、标准输入、单/多文件及通配符路径作为输入源
- 兼容 OpenAI、Anthropic、Ollama、DeepL 等多种翻译服务与模型
- 可通过 TOML 配置文件持久化设置默认参数、API 端点和网络选项
- 提供预设（presets）和自定义提示词模板功能，支持 @file 引用外部模板
- 灵活控制输出方式：stdout、指定输出目录、原地替换或添加后缀命名
- 支持并行翻译任务、dry-run 模式预览及严格的运行时错误检测
适用场景
在日常开发中，当需要将英文 README 或代码注释快速翻译成其他语言时，translate CLI 可以一行命令完成任务。例如 `translate –to zh README.md` 即可将文档翻译成中文，无需打开网页界面或复制粘贴内容，显著提升工作效率。对于 iOS/macOS 应用开发者来说，`.xcstrings` 是标准的本地化资源格式，而 translate CLI 原生支持此类文件的翻译，可直接处理 `Localizable.xcstrings` 文件，实现自动化本地化更新流程。 在团队协作或多项目环境中，配置管理变得尤为重要。通过 `config.toml` 文件统一设置默认使用的翻译服务提供商（如 Anthropic Claude）、API 密钥、超时时间等，所有成员只需记住基础命令即可保持一致的工作环境。结合预设功能，团队还能定义统一的翻译风格要求（如‘保持技术术语准确’），确保不同译者产出的一致性。 更高级的应用场景包括集成到自动化脚本中批量翻译整个项目的国际化资源。例如，在持续集成阶段自动调用 translate CLI 对新增的 `.po` 文件或 `.json` 本地化键值进行翻译填充，配合 `–dry-run` 和 `–parallel` 参数可在不影响生产环境的前提下高效测试翻译效果。对于重视数据安全的企业用户，选择 Ollama 本地运行模型或自建 OpenAI 兼容服务，则能在保证翻译质量的同时避免敏感信息外泄风险。