ssut/py-googletrans

项目介绍

Googletrans 是一个非官方的 Python 库，调用 translate.google.com 背后的网页接口，提供异步翻译、自动检测源语言、字符串列表批量翻译、自定义服务域名、代理支持和基于 httpx 的 HTTP/2。它面向 Python 3.8+，适合希望在脚本里快速加入翻译、又不想申请付费 API 的开发者。

工作原理

Google 网页翻译接口依赖由混淆 JavaScript 生成的 ticket 令牌。项目对令牌生成过程做了逆向并在 Python 中重新实现，README 也说明这种方式随时可能失效 README 第 31–44 行。

快速使用

从 PyPI 安装：

pip install googletrans

使用异步接口翻译；省略 src 时会自动检测源语言：

import asyncio
from googletrans import Translator

async def main():
    async with Translator() as translator:
        result = await translator.translate('안녕하세요.', dest='ja')
        print(result)

asyncio.run(main())

返回对象包含源语言、目标语言、译文和发音。批量翻译可直接传入字符串列表，detect() 返回检测到的语言及置信度。安装后还会提供命令行工具：

translate "veritas lux mea" -s la -d en

完整 API 说明见文档站。

使用约束

该库依赖非官方网页端点，与 Google 无关。单次文本最多 15,000 字符，README 明确不保证服务始终可用；出现 HTTP 5xx 或特定错误码通常意味着客户端 IP 被 Google 封禁。生产环境建议改用 Google Cloud Translation。项目采用 MIT 许可证，从 v2.0.0 起遵循语义化版本，但 0.x.y 版本可能随时做不兼容变更。

HotRepo 点评

本站没有该仓库的榜单记录或 Star 历史，因此无法根据站内数据判断热度趋势。可用的事实是项目创建于 2015 年、现有 4,292 Star 和 740 Fork，以及 README 自述的维护风险：逆向来的令牌生成只在 Google 未改动网页端时有效。它适合脚本和原型阶段的临时使用，一旦令牌方案失效，需要准备切换到官方 API。