用Golang开发轻量级翻译CLI工具的关键是选简单API、处理文本边界、设计简洁命令行。推荐使用DeepL或Google Translate的公开接口，避免复杂鉴权；通过flag包实现-t、-s、-f等基础参数，支持文件和stdin输入；利用net/http发起请求，goquery或json解析响应；预处理文本去空格换行，译后清洗多余空白；设置8秒超时，统一错误提示，失败时返回原句加警告标识；最终编译为单文件二进制，直接放入PATH运行，无需依赖环境。

用 Golang 写一个轻量级翻译 CLI 工具不难，关键在三点：选对 API、处理好文本边界、命令行交互要干净。下面直接说怎么落地。

选一个简单可用的翻译 API

推荐用 DeepL Free API（通过网页模拟） 或 Google Translate 的公开端点（非官方但稳定）。不建议一开始就对接需要 OAuth 或复杂鉴权的商业 API（比如 Azure Translator），会拖慢验证节奏。

• DeepL 的免费接口可通过 POST 到 https://www.deepl.com/translator 模拟表单提交，带 form data 参数（如 text、source_lang、target_lang），返回 HTML 后用 goquery 提取译文
• Google 翻译可调用 https://translate.google.com/translate_a/single，参数精简（client=gtx&sl=auto&tl=zh&dt=t&q=hello），响应是 JSON 数组，解析成本低
• 避免用需申请 key 的服务（如百度翻译），除非你明确要长期维护或商用——CLI 工具第一目标是“跑起来”，不是“合规上线”

用 flag 包搭出干净的 CLI 接口

不用引入 cobra 这类重型框架。Golang 自带的 flag 足够支撑基础需求：

• -t zh 指定目标语言（默认 en）
• -s auto 指定源语言（默认 auto）
• -f file.txt 支持文件输入（比粘贴长文本更实用）
• 无参数时从 stdin 读（echo "hello" | translate 这种管道流支持）

示例片段：

var (
  targetLang = flag.String("t", "en", "target language code")
  sourceLang = flag.String("s", "auto", "source language code")
  filePath   = flag.String("f", "", "input file path")
)
flag.Parse()
text := readInput(*filePath) // 自定义函数，优先读文件，其次 stdin

文本预处理与后处理不能省

用户输入往往带空行、多余空格、控制字符。不做清洗，API 可能返回异常或截断：

• 输入前：用 strings.TrimSpace 去首尾空白；用 strings.ReplaceAll(text, "\r\n", "\n") 统一行尾
• 翻译后：译文可能含多余换行或空格，用正则 regexp.MustCompile(`\n\s*\n`) 合并段落空行
• 特别注意：中英混排时，Google API 对中文标点（如“，”、“。”）识别稳定，但 DeepL 在纯中文短句上更准——可在工具里加个 -e deepl 切换引擎

错误处理要静默友好

CLI 不该崩，也不该堆栈溢出。网络失败、超时、API 返回非 200、JSON 解析失败……都统一转成提示语：

• 超时设为 8 秒（http.Client{Timeout: 8 * time.Second}），太短易失败，太长用户没感知
• HTTP 错误码 429 就提示 “Too many requests. Try again later.”，别暴露 header 或 raw body
• 解析失败时 fallback 到原句 + ⚠️ 标识，例如："hello" → "hello [translation failed]"

基本上就这些。核心逻辑不到 200 行，编译成单二进制，扔进 $PATH 就能用。不需要数据库、不用后台进程、不依赖 Node 或 Python——这才是 CLI 的轻量本意。