从零跑通LunaTranslator：视觉小说翻译工具3步配置教程
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
对着满屏外文对话看不懂？LunaTranslator 是一款视觉小说翻译器，它能直接从游戏里取出文本并即时翻成中文。下面是从零开始让它跑起来的最短路径。
它适合谁、能做什么
玩日语视觉小说、需要实时看到译文的人适合用它：
| 适合 | 不适合 |
|---|---|
| 文字类游戏实时翻外语文本 | 纯动作游戏、无固定文本框的游戏 |
| 没有汉化组更新的游戏 | 追求完全离线、无任何网络环境 |
| 需要把译文叠在原位或弹窗显示 | 只做字幕后期剪辑的场景 |
翻译引擎可在线可离线，具体取舍后面再讲。
装之前用2分钟过一遍这份清单
打开命令提示符，逐条确认：
- ✅ 系统是 Windows 7 及以上（Win10/11 64位体验最好）
- ✅ 已装 Python 3.9+：输入
python --version能输出版本号 - ✅ 已装 Git：输入
git --version能输出版本号 - ⚠️ 软件目录别放
C:\Program Files，否则无法保存配置
三步完成安装并启动
第1步：拿到源码
git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator判断做对了：命令结束后，当前目录多出一个 LunaTranslator 文件夹，里面有src和docs。
第2步：装依赖
pip install -r requirements.txt判断做对了：末尾输出Successfully installed，且无红色报错。
第3步：启动软件
cd LunaTranslator\src && run.bat判断做对了：弹出程序窗口，没有报错闪退。到这里，视觉小说翻译工具已经可用：启动游戏后，用 HOOK 模式选中游戏进程，再在候选行里挑出游戏文本那一条，译文就出来了。HOOK 可以理解为"从游戏内部直接取字"，比截图识别更准更快。
按需再调：翻译与语音引擎
- 【可选】翻译引擎：设置里可切换在线接口或大语言模型，离线翻译也能配，详见 docs/zh/
- 【可选】OCR 识别：游戏保护太强、HOOK 取不到文本时，切到 OCR 模式框选识别区域即可，相当于一台"文字扫描仪"
- 【可选】TTS 朗读：把译文读出来，用 Win11 可先试系统自带语音
前两步跑通后，这些都可以先跳过。
踩坑速查
| 症状 | 原因 | 解法 |
|---|---|---|
| 提示"Missing embedded Python3" | 杀毒软件删了组件 | 给整个软件目录添加信任后重新解压 |
| 一直"等待DLL注入到游戏中" | 同上，注入文件被拦截 | 添加信任，部分游戏改用管理员启动 |
| HOOK 后选不到文本 | 游戏位数与注入不符 | 换对应位数的版本，或改走 OCR 模式 |
| 无法保存设置 | 装在 Program Files 等受保护目录 | 把目录整体挪到普通路径 |
| pip 报"不是内部或外部命令" | 安装时没加 PATH | 重装 Python 并勾选 Add Python to PATH |
跑到这里，你已完成这套视觉小说翻译工具的全部基础配置。想深入 HOOK 参数、内嵌翻译或多语言包设置，去翻 docs/zh/ 即可。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
