KOReader 完整上手指南：新手快速把扫描 PDF 和 EPUB 调到最好读
【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader
扫描 PDF 在原生阅读器里只能放大缩小、满屏拖，字比芝麻还小。KOReader 是一款免费开源的电子书阅读器，运行在 Kobo、Kindle、PocketBook、Android 和 Linux 上，把扫描 PDF、DjVu 重排成可调字号的文本，覆盖 EPUB、FB2、Mobi、TXT 等格式。
一分钟自测：你需不需要它
- 书里有扫描 PDF 或 DjVu，内置阅读器只能缩放拖拽？需要。
- 读 EPUB 想自己换字体、调行距、改页边距？需要。
- 书都存在 Calibre，想无线传书、在线浏览书柜？需要。
- 想要靠触摸分区翻页，少按实体键？需要。
以上全是"否"，而且只读官方商店里现成的 EPUB——内置阅读器够用，不必折腾。
从下载到打开第一本电子书：最短路径
- 去项目发布页，下载与你设备对应的安装包；开发者也可以克隆仓库源码自行编译。
- Kobo：把文件复制到设备存储目录，重启设备；Android：直接安装 APK，授予文件访问权限。
- 启动 KOReader，文件管理器打开；首次运行默认扫的是设备主目录。
- 翻到放书的文件夹，双击一本 EPUB；正文重排显示，字号、页边距按你的习惯走。
- 顺手打开一本书看看菜单，确认翻页、高亮都正常。
- 老型号设备（旧 Kindle、PocketBook 等）的专属安装脚本，仓库 platform/ 目录里都有备着。
装完立刻能做的三件事
扫描 PDF 不用凑近看。内置 K2pdfopt 引擎把扫描图重排成可调字号的纯文本，字号、页边距随便调。
- 重排参数集中在 frontend/ui/data/koptoptions.lua，可按书选择是否重排
- 版式复杂的扫描本重排会出错，随时切回固定页显示，同一本书两种视图共存
查词、高亮、做笔记一条龙。长按单词弹出词典结果，顺手高亮句子或加笔记。
- 可用词典在 frontend/ui/data/dictionaries.lua 中维护，StarDict 本地词典离线可用
- 高亮、书签、进度都写进书籍旁的
.sdr伴生目录，换设备把书和.sdr一起拷过去即可
Calibre 书库当 OPDS 书柜。搜元数据、无线接收书、在线浏览书库，一次接好。
- Calibre 集成在 plugins/calibre.koplugin/，OPDS 浏览在 plugins/opds.koplugin/，不用就关掉
拨一拨就有感觉：五个体验开关
- 文字对比度：阳光直射或屏幕泛黄时，正文发灰看不清；顶部菜单滑杆调高即可。
- 字体与行距：外部字体、行距、页边距、对齐独立可调，换一套字体排版立刻不一样；选项在 frontend/ui/elements/font_settings.lua。
- 重排与固定页：扫描书重排乱行时，在阅读菜单切回固定页显示，30 秒搞定。
- 全刷频率：局部刷新快但有残影，隔几页全刷一次更干净；选项见 frontend/ui/elements/refresh_menu_table.lua。
- 插件开关：每个启用的插件都增加加载时间和内存，不用的按需求逐个关闭。
卡住了先看这张表
| 现象 | 大概率原因 | 30 秒解法 |
|---|---|---|
| 启动崩溃或白屏 | 启动过程抛了异常 | 在"关于"页打开数据目录下的crash.log查报错 |
| 高亮和进度丢了 | 只拷了书没拷.sdr伴生目录 | 复制书籍时连同.sdr目录一起拷 |
| 扫描书重排乱行漏字 | OCR 质量差、版式复杂 | 切固定页显示，或调 K2pdfopt 参数 |
| 屏幕残影明显 | 局部刷新累积 | 菜单或手势触发一次全量刷新 |
| 老设备翻页变卡 | 插件太多、在线服务抢资源 | 关掉在线词典、云同步和不用的插件 |
阅读数据都存在本机.sdr目录，云同步走你自己的凭据，设备上没有内置数据回传。
说句实话：谁可以不用装
- 只用内置阅读器读官方商店 EPUB、书量不大——内置方案够用。
- 设备很新、内置阅读器翻页和排版都满意——多一步安装和配置不值得。
- 只读固定页文档、不需要重排版和插件——折腾它没收益。
真正该装的，是手里有扫描书、想重排版、书库托管在 Calibre 的人。
bug 和想法报 issue，界面翻译进官方翻译平台认领，改代码前先跑一遍 spec/unit/ 的单元测试。
【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
