基于Translation插件实现在pycharm本地翻译并阅读英文资料

徐梓麒

380人浏览 · 2026-04-12 05:01:10

徐梓麒 · 2026-04-12 05:01:10 发布

背景

阅读资料需要阅读英文，但pycharm的translation需要联网到有道、微软等翻译引擎，查询词汇太慢。
本Blog探讨让translation插件拥有离线翻译能力，加快查询单词的速度。

要让它拥有纯离线翻译能力并实现“秒开”，目前有三种主流且有效的方案：

方法一：安装作者YiiGuxing 提供的专门定制版插件（最简单，推荐）

在 PyCharm 中，最知名的翻译插件是 YiiGuxing 开发的 Translation 插件。由于该插件为了保持轻量化，默认并没有内置离线词库，所有的翻译（如 Google、DeepL、有道、百度等）都需要通过网络请求调用云端 API。当网络波动或接口受限时，查询单词的速度就会变得非常慢。

作者专门编译了一个包含 LibreTranslate 引擎支持的过渡版本，安装这个版本后就能在菜单里直接选了。

下载定制版插件：
前往 GitHub 讨论帖 #5411 部署本地离线机器翻译服务并在插件中使用页面。在帖子的正文开头部分，找到并下载 TranslationPlugin-3.99.0-lt.zip 这个压缩包。
在 PyCharm 中离线安装：
- 打开 PyCharm 的 Settings (设置) -> Plugins (插件)。
- 点击顶部的齿轮图标 ⚙️ -> 选择 Install Plugin from Disk... (从磁盘安装插件)。
- 选中你刚下载的 TranslationPlugin-3.99.0-lt.zip 文件（注意：不需要解压，直接选 zip）。
- 点击 Apply 并重启 PyCharm 生效。
配置 LibreTranslate 引擎：
- 重启后，进入 Settings -> Tools -> Translation。
- 这时在 翻译引擎 (Translation Engine) 下拉列表中，就可以找到 LibreTranslate 了。
- 选择它，然后点开翻译引擎右侧齿轮，在 API 端点 填入你的本地 LibreTranslate 地址（例如：http://localhost:5000/translate）。如果有 API Key 就填上，没有留空即可。【注意：要本地安装并启动LibreTranslate ，首次启动要科学上网下载安装包】
配置快捷键，快速翻译
- 重启后，进入 Settings，在导航栏搜索Keymap，在右侧的内容搜索translation，把带有Ctrl+shift+Y的那个选项的translation快捷键，设置成Alt+W。
本地快速翻译效果

方案二：利用 Ollama 部署本地大模型（充当离线 OpenAI API）

Translation 插件本身原生支持 OpenAI 引擎。如果你电脑的性能较好（有独立显卡或较强的 CPU），可以通过部署本地的离线 LLM 模型来实现离线翻译，效果极佳且能结合代码上下文。

1. 下载并运行本地模型

安装 Ollama（一个本地跑大模型的工具）。
在终端运行一个极小巧且速度极快的模型（比如 Qwen 的 0.5B 版本，占用极低，查词飞快）：
```
ollama run qwen2.5:0.5b
```

2. 配置 Translation 插件

在 PyCharm 中打开 Settings -> Tools -> Translation。
将翻译引擎切换为 OpenAI。
API 地址 (API URL) 修改为本地 Ollama 的兼容地址：http://127.0.0.1:11434/v1
模型 (Model) 手动输入：qwen2.5:0.5b（与你下载的模型名一致）。
API Key 随便填任意字符（如 sk-1234，由于是本地 API，Ollama 不会校验这个密钥，但插件可能要求不能为空）。
保存后，你就可以用本地 AI 零延迟离线查词了。

方案三：使用系统级“离线词典”工具（最简单高效的曲线救国法）

如果你只是想单纯地加快单词查询速度，而不想在本地部署大模型或后台服务，其实放弃 IDE 内部翻译插件，改用系统级全局词典软件是日常开发效率最高的选择。

Windows 用户推荐：安装 欧路词典 (Eudic) 或 GoldenDict。它们支持下载海量的离线词库（几十MB的本地词典包）。只需在后台开启“划词翻译”或“快捷键取词”功能。在 PyCharm 里双击选中一个变量名，按下你设定的快捷键（例如 Ctrl+C 连按两次），立刻就能弹出离线翻译，速度远比任何插件都要快。
macOS 用户推荐：Mac 系统本身自带极强的离线系统词典。在 PyCharm 中，选中单词后，使用自带快捷键 Control + Command + D（或者触控板重按），就能直接调用 macOS 的离线词典弹窗，做到真正常驻内存、零延迟离线查询。

参考来源：