根本原因是默认在线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 进程开着、插件指向对、快捷键设对——剩下就是每天多读两页英文文档的事了。
