10分钟跑通LunaTranslator视觉小说翻译器：从零开始的环境准备、首次启动与常用配置指南-酒店常州论坛

10分钟跑通LunaTranslator视觉小说翻译器：从零开始的环境准备、首次启动与常用配置指南

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator

LunaTranslator 是一款 Windows 视觉小说（Galgame）翻译器：用 HOOK 或 OCR 从游戏里提取文本，交给各家翻译引擎出译文，还能把译文写回游戏里直接读。这篇文章带你从零把克隆下来的代码跑起来，并调好最常用的几项设置。

📦 环境准备：安装 LunaTranslator 前检查这几点

操作系统：这是 Windows 专用工具。正式发布的打包版支持 Win10（1803+）/ Win11 64 位，另有兼容 Win7 甚至 XP 的旧版，见官方文档 docs/zh/README.md。
运行依赖：打包版已内嵌 Python 运行时，解压即用，不需要你装 Python。如果你要在本仓库源码上直接跑，需要本机有可用的 Python（PyQt5 等依赖），入口是 src/LunaTranslator/main.py。
原生组件：HOOK 注入、本地 OCR 等由 src/NativeImpl/ 的 C++ 代码编译而来，打包版已包含成品 dll/exe；若要改原生层，需要准备 CMake + MSVC 编译环境（构建脚本在 src/scripts/）。
网络：在线翻译和 OCR 引擎都要走网络；网络受限时建议在软件的代理设置里配代理（详见 docs/zh/qa1.md 相关章节）。

🚀 首次启动：从源码到看到第一句游戏译文

走哪条路线取决于你的身份：普通用户直接下载打包版；开发者可以直接跑源码。

把软件放到可写目录（打包版解压、源码 clone 后都同理），避开C:\Program Files这类受保护路径。判断成功：能正常打开该目录并读写，里面能看到LunaTranslator.exe（打包版）或src/目录（源码）。
启动程序。打包版双击LunaTranslator.exe（个别游戏需要管理员权限 HOOK 时才用_admin版本）；源码路线则双击 src/run.bat，它实际执行的就是：
```
python.exe -B LunaTranslator\main.py
```
判断成功：弹出 LunaTranslator 主窗口，没有报错弹窗；首次启动会自动检测语言并写入配置。
接入一个已启动的游戏：点工具栏的选取进程按钮，选中游戏进程。判断成功：游戏被注入，随后弹出“选择文本窗口”。
挑出文本行：让游戏跑一段剧情，选择文本窗口里会出现若干候选行，选中与游戏文本吻合的那一行开始翻译。判断成功：该行显示译文，支持内嵌翻译的游戏还会多出“内嵌”按钮（完整流程图解见 docs/zh/basicuse.md 同目录的 basicuse 页 docs/zh/basicuse.md）。

🎛️ 常用配置参数调优：最常改的 5 项设置

你的配置存在软件目录下的userconfig文件夹里，主配置是config.json（仓库里的出厂默认值在 src/LunaTranslator/defaultconfig/config.json）：

软件目录\userconfig\config.json ← 主配置 软件目录\userconfig\ocrsetting.json ← OCR 相关

界面里改和在 JSON 里改是同一个东西，改完重启软件生效。最常动的几项：

参数名	默认值	修改后效果	谁需要改
`languageuse2`	跟随系统语言（中文系统即`zh`）	切换软件界面语言	需要日文/英文界面的人
`tgtlang4`	与界面语言相同	设定翻译的目标语言	想把游戏译成非中文的人
`fanyi.youdaodict.use`/`fanyi.google.use`	中文系统默认启 youdaodict，其余启 google	决定默认使用哪个翻译引擎	想换翻译源、或同时挂多个引擎的人
`history.autosave`	`false`	设为`true`后翻译结果自动进历史记录，方便回看	需要复盘翻译记录的人
`disappear_delay`	`5`	调整文本消失前的等待秒数，文本停留更久或更快	觉得译文一闪而过 / 显示太拖沓的人

翻译引擎的具体启用与排序，在界面“翻译设置”里勾选更方便；引擎清单可参考文档 docs/zh/guochandamoxing.md。

🗂️ 核心目录速览：改代码前先认准这几个目录

目录	作用	什么时候要看它
src/LunaTranslator/	Python 主程序：`main.py`入口、`translator/`各翻译引擎、`ocrengines/`各 OCR 引擎、`tts/`语音合成、`gui/`界面	排查某个功能行为、加一个新翻译引擎
src/NativeImpl/	C++ 原生层：`LunaHook/`游戏与模拟器 HOOK、`NativeUtils/`本地 OCR 等	HOOK 注入失败、模拟器适配问题
`软件目录\userconfig\`（运行时生成）	你改过的配置、缓存	改设置前、换机迁移时（迁移只带这个文件夹即可）
src/LunaTranslator/defaultconfig/	出厂默认配置模板	对照“我到底改了什么”
docs/zh/	中文用户手册：HOOK 设置、OCR、TTS、模拟器等	想深入某个功能的使用细节

❓ 常见问题：新手起步期 3 个高频坑

Q1：启动报“Missing embedded Python3”，或 HOOK 时一直“正在等待DLL注入到游戏中……”？多半是杀毒软件把用于注入的组件（如LunaSubprocess32.exe、LunaHost32.dll）当作威胁删掉了。把整个软件文件夹加入 Windows Defender 的排除项（“病毒和威胁防护 → 排除项”），或临时关杀软后重新解压一次。详见 docs/zh/README.md 的“常见错误”一节。

Q2：保存设置失败，或启动报PermissionError？软件被放进了C:\Program Files这类受保护路径，配置和缓存写不进去。把整个软件目录移到有写权限的位置（如D:\Luna）再启动即可。

Q3：想升级或重装，旧文件夹能直接删吗？手动升级只需下载新版本、解压覆盖到原目录。千万不要删userconfig文件夹，否则之前所有的设置会全部丢失。

【免费下载链接】LunaTranslator视觉小说翻译器 / Visual Novel Translator项目地址: https://gitcode.com/GitHub_Trending/lu/LunaTranslator

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析