LunaTranslator 零基础上手：视觉小说翻译工具 5 步从克隆到首次跑通

LunaTranslator 零基础上手视觉小说翻译工具 5 步从克隆到首次跑通【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslatorLunaTranslator 是一款开源的视觉小说翻译器专为想读外文书本/游戏但读不动原文的玩家设计它能从游戏画面里自动把台词抓出来实时翻译成中文还能直接念出来。跟着这篇 LunaTranslator 上手教程走一遍零基础的你也能在十几分钟内让它在本地跑起来。它替你解决了哪些麻烦先对号入座看看你有没有下面这些困扰玩日语音游看到满屏假名片假名只能靠猜剧情想翻译某句台词得先截图、再贴到翻译网站、再复制回来一局下来截图几十张翻译出来的文字只想看如果能听就更好了。LunaTranslator 的核心能力就是冲着这三件事来的HOOK 模式直接从游戏内存里取出文本。就像游戏里一个隐形复制按钮你不用截图文字自己排队送到翻译窗口OCR 模式HOOK 搞不定时框选一块屏幕区域把画面里的字扫出来识别。相当于一台随身文字扫描仪多引擎实时翻译内置 Google、百度、腾讯等多家翻译接口抓到的文本即时转换延迟通常在秒级TTS 语音朗读把译文读出声走路、躺床上都能听剧情。如果以上场景命中一两个这套工具就是为你准备的。开跑前 30 秒自查LunaTranslator 的源码版本跑在 Python 上所以你的电脑需要满足这张表检查项最低要求推荐操作系统Windows 10 64 位Windows 10 / 11 64 位Python3.73.9Git任意较新版本最新稳定版磁盘空间1 GB 可用3 GB 可用下面两个工具装好即可每个动作后我都附了验证命令和预期输出。1. 安装 Git用来下载源码官网免费安装时务必勾选 Add Git to PATH然后打开命令提示符开始菜单搜cmd回车验证git --version预期输出类似git version 2.43.0.windows.1看到版本号就说明装好了。2. 安装 Python运行源码的发动机从 python.org 下载 3.9 版本安装界面第一项 Add Python to PATH必须勾选否则后面所有python命令都会失效。装完同样在 cmd 里验证python --version预期输出类似Python 3.11.0。⚠️ 两条验证命令只要有一条报不是内部或外部命令就说明 PATH 没配好重装时勾选对应选项即可别硬往下走。从克隆到跑起来四步走以下命令全部在 Windows 命令提示符中执行。第 1 步把源码克隆到本地在你想放工具的目录别放C:\Program Files这种受保护路径配置文件会写不进去执行git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator完成后用dir列一下当前目录确认多了LunaTranslator文件夹里面能看到src和docs两个子目录说明下载完整。第 2 步进入项目源码目录cd LunaTranslator\srcsrc是整个程序的实际入口后面所有操作都从这里开始。第 3 步安装 Python 依赖LunaTranslator 的界面基于 PyQt5 构建源码里没带依赖清单手动补装核心两个库即可pip install PyQt5 tinycss2预期输出以Successfully installed ...结尾。如果中途报代理/超时错误把 pip 源临时换成国内镜像-i https://pypi.tuna.tsinghua.edu.cn/simple重试。第 4 步启动主程序python LunaTranslator/main.py这一行就是run.bat里干的事手动执行方便你直接看到报错信息双击 bat 闪退时问题被吞掉了。第一次启动验证上面第 4 步其实就是最简验证屏幕上弹出 LunaTranslator 主界面窗口即算成功。正常情况下你会看到一个带侧边设置栏的窗口左侧能看到文本获取翻译等分类设置项主窗口标题含 LunaTranslator 字样。只要窗口正常显示、没有闪退你的环境就完全跑通了——它甚至会在启动时自动检查并下载缺失的运行时组件首次启动稍等片刻属正常现象。如果窗口弹不出来cmd 里一定有红色 Traceback 报错把它对照下一节排查即可。 验证通过后日常使用直接双击src目录下的run.bat启动即可32 位系统用run32.bat。高频坑位速查现象原因一句话解法python或pip报不是内部或外部命令安装 Python 时没勾 Add Python to PATH重装 Python 并勾上该选项启动后闪退run.bat窗口一闪而过报错被pause前的异常吞掉看不到具体信息改用python LunaTranslator/main.py手动启动让报错留在屏幕上ModuleNotFoundError: No module named PyQt5依赖没装或装到了另一个 Python 版本用python -m pip install PyQt5 tinycss2确保装到当前解释器HOOK 注入失败 / 卡在等待 DLL 注入杀毒软件把注入用的组件当成威胁清掉了把 LunaTranslator 文件夹加入杀毒软件排除项后重启游戏游戏是 32 位HOOK 始终抓不到文本32/64 位引擎不匹配用run32.bat对应的 32 位 Python 环境启动 更细的排查思路比如 OCR 区域怎么框、翻译接口怎么换都在项目自带的中文文档里建议收藏 docs/zh/README.md 和 docs/zh/basicuse.md。走到这里工具已经在你电脑里跑起来了剩下的只是把它挂到你的游戏上享受无障碍阅读吧。遇到文档没覆盖的问题项目文档里的社区入口随时欢迎你去提问。【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考