LunaTranslator 视觉小说翻译器：零基础上手，5 分钟跑通游戏文本翻译
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
LunaTranslator（视觉小说翻译器）能把游戏里的外文对话实时翻译成中文：它通过 HOOK（直接从游戏内存里"偷看"文字的技术）、OCR（把截图里的文字识别出来的图像识别技术）或剪贴板三种方式捕获游戏文本，再调用翻译引擎输出译文，还支持把译文直接嵌回游戏画面里。全文按"克隆代码 → 启动 → 完成第一次翻译"三步走，你照着做即可跑通。
开工前：3 分钟确认你的环境
| 检查项 | 最低要求 | 推荐 | 说明 |
|---|---|---|---|
| 操作系统 | Windows 7+ | Windows 10 64 位 | HOOK 注入依赖 Windows 平台 API |
| Python | 3.6+ | 3.9+ | 启动main.py需要 |
| Git | 任意较新版本 | 最新版 | 用于克隆代码 |
| 硬盘空间 | 2 GB | 5 GB+ | 代码、依赖与缓存 |
操作：按Win+R输入cmd，执行以下两条命令确认前两项。
python --version # 应显示 Python 3.6 及以上 git --version # 应显示版本号验证：两条命令都有版本号输出即通过；如果显示"不是内部或外部命令"，说明安装时没勾选 Add to PATH，重装时勾上即可。
📌 系统要求就三条：Windows、Git、Python，都能输出版本号就开工。
克隆代码的 4 个动作
目标：把 LunaTranslator 源码拿到本地并确认完整。
操作：
cd D:\Tools # 切换到你想存放项目的目录，换成你的实际路径 git clone https://gitcode.com/GitHub_Trending/lu/LunaTranslator cd LunaTranslator dir # 列出目录内容验证：dir输出里能看到src、docs、LICENSE三样，说明代码下载完整。
如果看到'git' 不是内部或外部命令→ 执行"重装 Git 并勾选 Add Git to PATH"修复后重试。
📌 克隆完用 dir 核对 src 和 docs 两个目录，缺了就重新 clone。
启动软件并跑通第一次翻译
启动
目标：让 LunaTranslator 主界面第一次打开。
操作：
cd src run.bat # 等价于执行 python.exe -B LunaTranslator\main.py验证：黑色命令行窗口之后弹出主界面窗口，界面能正常显示、工具栏按钮可用即启动成功。
如果窗口一闪而过或命令行报 ModuleNotFoundError → 执行python --version确认版本并补装缺失依赖修复。⚠️ 不要把软件目录放在C:\Program Files这类特殊路径下，否则即使管理员权限也无法保存配置，建议放到D:\Tools这类普通路径。
第一次翻译（HOOK 模式）
目标：让一段游戏文本被捕获并翻译成中文。
操作：
- 先在系统里把游戏跑起来，再打开 LunaTranslator 的工具栏，点 HOOK 模式按钮
- 在弹出的进程选择窗口里选中游戏进程，点确认，软件会注入（把功能模块"塞进"游戏进程）并弹出选择文本窗口
- 回游戏里点几下让对话出现，候选文本行里会出现若干行，选中与游戏对话一致的那一行，翻译即开始
验证：选择文本窗口里，被选中的行下方出现了中文译文。
偷懒技巧：把游戏程序的 exe 直接拖进 LunaTranslator 主窗口，它会以正确位数的环境启动游戏并自动完成 HOOK，省去前面第 1、2 步。
📌 HOOK 模式下选对"游戏文本行"是翻译开始的关键，选错了换一行即可。
高频踩坑：现象、原因与一句话解法
| 现象 | 原因 | 一句话解法 |
|---|---|---|
| 提示"找不到重要组件"，或卡在"正在等待DLL注入到游戏中……" | 注入用的组件（LunaSubprocess32 等）被杀毒软件当病毒删了 | 把软件文件夹加入杀毒排除项，重新下载/克隆 |
| 运行报 PermissionError 或设置保存不进去 | 软件放在了C:\Program Files等受保护路径 | 整个目录挪到普通路径，别删掉 userconfig 文件夹 |
| 注入失败或捕获不到文本 | 游戏要求管理员权限，或 32/64 位引擎与游戏不匹配 | 以管理员身份启动，或换用与游戏位数对应的版本 |
如果 OCR 模式识别乱码或没反应：检查是否点错了按钮——图标相似的连续识别和单次识别是两个不同功能，持续翻译要用连续识别那个；OCR 参数可调项较多，完整说明见 docs/zh/ocrparam.md。
📌 九成启动失败都是杀毒软件或安装路径的锅，先查这两处。
翻译跑通后，可以顺着两条线往下玩：给翻译结果加上读音与分词，参考 docs/zh/jiebapinyin.md；接更多翻译与 OCR 引擎，参考 docs/zh/useapis/tsapi.md。打开游戏，点一下 HOOK，你的第一次翻译现在就发生。
【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
