常见问题
首字下沉、底图气泡、主题绑定和规则优先级异常时,按现象快速查找处理办法。
这页用于排查高亮效果异常,不是从零开始创建高亮规则的教程。你可以直接按现象查找对应小节;后续出现新的高频问题,也会继续补充到这里。
首字下沉跑到下一段
如果首字下沉有时命中第一段,有时跑到第二段,优先检查规则是不是靠正则定位标题或段首。
书籍里的标题、空行、标点和正文开头格式并不统一,一条正则很难稳定覆盖所有章节。遇到章节结构稍微变化,匹配位置就可能偏移。
更稳定的处理方式是把规则限制在标题范围内:
- 在阅读页打开右上角「高亮规则」
- 点右上角菜单新建规则
- 在作用内容里选择「标题」
- 保存后回到阅读页查看效果
这样规则跟随应用识别到的标题范围,不需要用复杂正则硬匹配。
首字跨行效果和预期不一致
想控制首字是否像纸书一样占多行,去看「浮动布局」开关。
路径:
- 打开阅读页「设置」
- 进入「更多设置」
- 打开「精装书样式」
- 调整「浮动布局」
开启后,首字更可能按浮动排版参与多行环绕;关闭后,首字下沉对正文行的影响会更弱。不同书籍自带样式不同,调整后建议回到当前章节实际看一眼。
背景图被拉长或压扁
高亮底图并不是按原图比例完整贴上去,而是铺在命中内容形成的区域里。文字变多时,区域会变高或变宽,图片也会随之拉伸。
如果想让变形不明显,可以从这几个方向处理:
- 给底图设置 9-Slice 拉伸,让边角尽量保持原样
- 为短句、长段落、对话等不同内容准备不同底图
- 缩小规则命中范围,避免一张图同时包住过长内容
复杂花纹、人物、明显图案更容易看出拉伸痕迹。做高亮底图时,边缘简单、中心可延展的图片通常更稳。
关闭规则后阅读页仍然显示高亮
这种情况通常不是规则列表里的开关没关,而是当前阅读主题绑定了高亮规则。
主题绑定的高亮会跟随主题一起启用。导入别人分享的主题时,如果主题里带了绑定高亮,就可能出现「规则列表里关了,阅读页还是有」的现象。
处理步骤:
- 打开阅读页「阅读主题」
- 把主题设置拉到底
- 进入「绑定高亮」
- 选择重置,解除所有绑定
- 再回到高亮规则列表确认启用状态
预览没有显示字体、颜色等自定义效果
先检查「精装书样式」里有没有关闭相关 CSS 项。
高亮样式最终会转成 CSS 应用到命中的文字上。如果精装书样式里禁用了字体、颜色、浮动、间距等能力,对应的高亮参数也可能在预览和阅读页里看不到。
检查路径:
- 打开阅读页「设置」
- 进入「更多设置」
- 打开「精装书样式」
- 找到和当前高亮效果相关的样式项
- 临时开启后回到高亮预览确认
如果只是不确定哪一项影响效果,建议一次只改一项,方便判断原因。
底图有时按段显示,有时按行重复
给规则明确指定 display,可以减少自动判断带来的差异。
想让高亮更像随文字流动,可以使用:
display: inline;想让命中内容更像整段气泡,可以使用:
display: block;两种写法选一种即可,不要同时写。需要注意的是,EPUB 自带 CSS 也会参与排版,如果原书样式很复杂,即使写了 display,最终效果也可能受原书影响。
气泡边缘包不住文字
气泡超出、贴边或留白不对时,优先调边距。
不同底图的透明区域、圆角、阴影和装饰边框都不一样,不能直接套用别人的参数。可以从这些项开始微调:
- 内边距:调整文字到气泡边缘的距离
- 外边距:调整气泡和上下文的间隔
- 左右边距:处理气泡横向包裹范围
- 上下边距:处理顶部和底部留白
建议先把气泡调到能完整包住文字,再根据底图装饰留出余量。每次只改少量参数,预览会更容易判断。
开启高亮后原书排版乱了
这类问题多见于本身带复杂样式的 EPUB 或 HTML 书籍。
原因通常是原书 CSS 和高亮 CSS 同时控制同一段内容。字体、字号、颜色、间距、对齐、背景、浮动等属性发生冲突时,页面就可能和原书差很多。
可以按目标选择处理方式:
- 想优先保留原书样式:关闭对应高亮
- 只想轻微标记:改用文字颜色、下划线等低影响样式
- 只想标记特定内容:缩小规则范围,避免整段或整页被套样式
如果关闭高亮后排版恢复,就基本可以判断问题来自样式冲突。
新启用的规则被其他高亮盖住
高亮规则会按列表顺序应用,越靠前的规则优先级越高。
如果你启用了一条规则,却看到另一条规则的效果,通常是上方规则先命中了同一段内容,把后面的规则盖住了。这个优先级和主题绑定没有直接关系,主要看规则在列表里的位置。
处理办法:
- 把需要优先生效的规则移动到更靠前的位置
- 临时关闭上方可能冲突的规则
- 缩小上方规则的匹配范围,避免覆盖下面的规则
调整顺序后,回到阅读页确认实际命中效果。
点高亮时误触编辑,影响翻页
如果阅读时经常点到高亮文本,导致翻页被打断,可以关闭「高亮文本可点击编辑」。
路径:
- 打开阅读页右上角「高亮规则」
- 点右上角菜单
- 关闭「高亮文本可点击编辑」
关闭后,高亮仍会正常显示,只是不再优先响应点击编辑,更适合纯阅读场景。

Reeden