如何用 LunaTranslator 给视觉小说开实时翻译：从 0 到跑通的完整新手教程
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator 是一款免费、开源的视觉小说实时翻译工具，它能自动捕获游戏里的外文文本，并立刻在悬浮窗口里显示出中文翻译，让你玩日文、英文视觉小说时不用硬啃生词。跟着这篇视觉小说实时翻译教程走一遍，你就能在自己的电脑上把工具跑起来。
先跑起来：三步把 LunaTranslator 装好
新手最容易犯的错是一上来就纠结配置。咱们反过来：先让程序跑通，再慢慢调。
第一步：备齐两个基础软件
| 配置项 | 最低要求 | 推荐 |
|---|---|---|
| 操作系统 | Windows 7 SP1 | Windows 10 / 11 |
| Python | 3.9 或更高 | 最新稳定版 |
| 硬盘空间 | 2GB | 5GB 以上 |
| 网络 | 能正常上网 | 5Mbps 以上（在线翻译引擎需要） |
安装 Python 和 Git 时，务必勾选 "Add to PATH" 选项，否则后面所有命令都会报"找不到"。
第二步：把项目代码下载到本地
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator第三步：装依赖并启动
按 docs/ 里的说明用 pip 把 Python 依赖装好，然后双击src/run.bat（64 位系统）或src/run32.bat（32 位系统）。首次启动会弹出默认配置，不用动它。
⏱️ 第一次装依赖大概要 5-10 分钟，取决于网速。看到主界面出现，就算跑通了。
⚠️ 坑提醒：如果双击
run.bat闪退，九成是 Python 没加 PATH 或版本低于 3.9。
游戏文字是怎么被读出来的：三种捕获方式怎么选
装好之后你会好奇：它凭什么能看见游戏里的文字？LunaTranslator 用了三种互补的"文本捕获"方式，理解了它们的差别，你就知道什么时候该用哪种。
- HOOK（内存文本读取）：说白了就是让工具"钻进"游戏进程内部，直接从游戏内存里把要显示的文字抄出来。不截图、不影响画面，速度最快。
- OCR（光学字符识别）：工具周期性对游戏窗口截图，用图像识别技术把画面上的字"认"出来。游戏用任何方式画字它都能看，但受字体和背景影响。
- 剪贴板监控：你复制任何文字，工具立刻捕获并翻译。最简单，但要你动手复制，不算全自动。
三种方式的选型对比：
| 方式 | 原理一句话 | 优势 | 短板 | 适用场景 |
|---|---|---|---|---|
| HOOK 内存读取 | 注入游戏进程直接读内存 | 最快、最准、不挡画面 | 部分游戏反作弊/特殊架构会拦截 | 大多数视觉小说的首选 |
| OCR 图像识别 | 截图 + 图像文字识别 | 什么游戏都兼容 | 受字体、背景干扰，速度稍慢 | HOOK 失败的游戏、加密文本 |
| 剪贴板监控 | 抓取你复制的文本 | 简单可靠 | 需手动复制，非全自动 | 前两者都不灵时的兜底 |
💡 实践结论：90% 的情况先试 HOOK，失败再切 OCR，剪贴板留给"疑难杂症"。
选对引擎：翻译、OCR、TTS 三件套怎么配
跑起来之后，真正的体验差距在"引擎选型"上。LunaTranslator 把三类引擎分开放置：翻译引擎在 src/LunaTranslator/translator/，OCR 引擎在 src/LunaTranslator/ocrengines/，语音合成（TTS，就是"把文字念出来"的功能）在 src/LunaTranslator/tts/。
按你的游戏语言，直接抄这份推荐配置：
| 场景 | 翻译引擎 | OCR 引擎 | TTS |
|---|---|---|---|
| 日语视觉小说 | DeepL（质量高）或谷歌（语言全） | Windows 内置 OCR 或 Tesseract + 日语包 | Edge TTS 日语音色 |
| 英语视觉小说 | 谷歌翻译 | Tesseract + 英语包 | Edge TTS 英语音色 |
| 网络差 / 想离线 | Sakura 本地模型 | 同上 | 本地 TTS 引擎 |
几个选型要点：
- 在线 vs 离线翻译：在线引擎（DeepL、谷歌、百度等）质量高但依赖网络，延迟 0.5-2 秒；离线模型（如 Sakura）免费、无延迟上限，但需要先把模型下载到本地。
- OCR 引擎：不想折腾就选 Windows 内置 OCR；追求效果就选 Tesseract，但要多装语言包。
- TTS 不是必须：想边看边听再开，音色、语速、音量都可以在设置里单独调。
💡 所有翻译相关配置最终都落在 src/LunaTranslator/defaultconfig/translatorsetting.json，改配置前可以先备份这个文件。
场景实战：两份可以照抄的配置
场景一：经典日语视觉小说，HOOK 实时翻译
以任意一款日语 VN 为例：
- 正常启动游戏，让画面走到有对话的地方
- 在 LunaTranslator 主界面选择"附加进程"，从列表里点选游戏进程，确认注入
- 程序会弹出"选择文本窗口"，列出若干候选文本行——挑出和画面上字幕一致的那一行
- 搞定。之后游戏里每出现新句子，翻译就会自动跳进悬浮窗口
💡 偷懒技巧：游戏启动后，直接把游戏程序图标拖到 LunaTranslator 窗口上松开，它会替你完成附加 + 注入。
翻译源语言选日语、目标语言选中文；想要"内嵌"到游戏窗口里的翻译，就在文本窗口里点对应行后面的"内嵌"按钮（不支持的游戏只会显示"显示"）。
场景二：英语视觉小说 + 双语学习模式
把 LunaTranslator 当英语听力/阅读工具用：
- 源语言设为英语，目标语言设为中文，翻译引擎选谷歌
- 开启 TTS，音色选英语女声，让它朗读原文——字幕出现时耳朵同步听到，这就是最简单的跟读训练
- 遇到生词，用内置词典功能查词，再配合 src/files/lang/ 里 20 多种界面语言，把界面切到你想练的语言
- 用 OCR 或 HOOK 捕获游戏文本，翻译延迟保持默认即可
不灵了怎么办：常见问题排查表
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
| HOOK 注入失败 | 游戏有反作弊保护，或架构特殊 | 以管理员身份运行；换 OCR 模式兜底 |
| 翻译延迟高 | 在线引擎网络慢 | 换更快的在线引擎，或切到 Sakura 本地模型 |
| OCR 错字多 | 字体小、背景花、动态立绘 | 调大游戏窗口；用"分析图像更新"模式并调整图像稳定性阈值 |
| 文本出现了却不翻译 | 选错了候选文本行 | 重新打开文本窗口，重新点选正确的那一行 |
| 启动就报错 | Python 版本不对或依赖缺了 | 重装 Python 3.9+（记得勾 PATH），再重装依赖 |
⚠️ 排查时先区分"没捕获到文本"还是"没翻译出来"：悬浮窗口里有原文说明捕获正常，问题出在引擎配置。
进阶玩法：从"能用"到"顺手"
- 自定义术语词典：游戏里反复出现的专有名词（人名、地名、道具），可以在 src/LunaTranslator/transoptimi/noundict.py 里加固定译法，避免同一名词每次翻译都不一样。例如给"セーブ"固定译成"存档"。同类模块还有翻译错误自动修正（transoptimi 目录下的 transerrorfix）。
- 多语言界面：src/files/lang/ 里有 20 多种语言的界面翻译文件。想加新语言，复制
en.json改名为新语言代码，逐条翻译字符串后提交贡献即可。 - 反馈与求助：详细使用文档在 docs/zh/（HOOK、OCR 参数、快捷键都有专页）；遇到 bug 或有建议，直接在项目的 issue 区提，作者响应很快。
LunaTranslator 是开源项目，代码、文档、配置都对你敞开。把上面的步骤走完，你手上就不只是个"翻译器"，而是一套能按游戏特性随时调整的语言桥——下一步，挑一款一直想玩却没下手的视觉小说，开跑吧。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
