根本原因是默认在线api导致卡顿,需手动安装支持libretranslate的定制版插件并本地运行libretranslate服务。

Translation 插件装不上、翻译慢、点右键没反应?根本原因是默认版本只走在线 API,网络一卡就卡死。想真正在本地快速查单词、读文档、看报错,得用带 LibreTranslate 支持的定制版,而不是 Marketplace 里那个“看起来能用”的原版。
装错版本是最大坑:别从 Marketplace 直接搜 Translation 安装
Marketplace 里的官方 Translation 插件(最新稳定版如 4.0+)已移除对本地引擎的支持,所有翻译都强制走 Google/DeepL 等云端接口。你遇到的“翻译按钮灰色”“右键无 Translate 选项”“Ctrl+Shift+Y 没反应”,90% 是因为插件没加载成功或引擎配置为空。
正确做法是跳过 Marketplace,手动安装作者 YiiGuxing 提供的过渡版本:
- 去 GitHub 讨论帖 #5411 下载
TranslationPlugin-3.99.0-lt.zip(注意后缀是-lt,代表 LibreTranslate 支持) - PyCharm 设置 →
Plugins→ ⚙️ 齿轮 →Install Plugin from Disk→ 直接选这个 zip 文件(不需解压) - 重启后,Settings →
Tools→Translation才会出现LibreTranslate这个选项
没启动 LibreTranslate 服务,插件再好也白装
装完插件只是第一步。LibreTranslate 是个独立 HTTP 服务,不是插件内置的——它得你自己在本地跑起来,插件才连得上。
常见错误现象:Translation Engine 下拉菜单里能看到 LibreTranslate,但点了测试就报 Connection refused 或 timeout。
必须做三件事:
- 用
pip install libretranslate安装服务(首次运行会自动下载模型,需科学上网) - 命令行执行
libretranslate --host 127.0.0.1 --port 5000启动服务(端口可自定义,但插件配置里要一致) - Settings →
Translation→ 引擎选LibreTranslate→ 齿轮图标 →API 端点填http://localhost:5000/translate
快捷键和右键菜单失效?检查 Keymap 和上下文范围
Ctrl+Shift+Y 默认绑定的是“翻译选中文本”,但它只在编辑器内生效;控制台(Console)、调试窗口(Debug Console)、甚至 .md 文件里都不触发——这不是 bug,是设计如此。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包,下载地址指向官方 Windows 安装包直链,可用于旧项目兼容、版本回退和环境测试。
如果你习惯在 PyCharm 的 Python Console 里粘贴英文报错信息想直接翻译,会发现右键菜单根本没有 Translate 项。
解决办法很实际:
- Settings →
Keymap→ 搜索translation→ 把Translate Text快捷键改成全局可用的组合(比如Alt+W),避免被其他面板拦截 - 翻译报错信息时,先复制到普通 Python 文件或临时
.txt文件里再选中操作 - 确认当前文件类型被插件支持:默认支持
TEXT、PYTHON、PLAIN_TEXT,但不支持CONSOLE类型
离线能用,但别指望专业术语全准
LibreTranslate 是基于 OPUS 开源模型的轻量级服务,优势是快、稳、纯本地,劣势是技术文档类长句、缩写(如 EOFError、__pycache__)、框架专有名词(如 Pydantic、FastAPI)可能直译不准,甚至漏译。
它适合快速理解报错大意、扫读文档段落、翻译变量注释,但不适合替代人工校对或生成发布级文案。
真正卡住你的往往不是“装不上”,而是“装上了但没跑服务”或“用了在线版却以为能离线”。把 libretranslate 进程开着、插件指向对、快捷键设对——剩下就是每天多读两页英文文档的事了。










