Antares SQL 查询历史记录高亮显示问题分析与解决方案

问题背景

在Antares SQL数据库管理工具中，用户发现历史查询记录模块存在一个显示异常问题。当用户在历史记录中搜索特定查询时，搜索结果中出现了未渲染的HTML标签，而不是预期的视觉高亮效果。这个问题影响了用户体验，使得搜索结果的视觉反馈不够直观。

问题现象

用户在历史记录面板进行搜索时，预期看到的是搜索关键词以特殊样式（主色加粗）高亮显示。然而实际呈现的是未经处理的HTML标签字符串，如<span class="text-primary text-bold">SELECT</span>直接显示在界面上，而非渲染后的视觉效果。

更复杂的是，当SQL语法高亮功能与搜索高亮功能同时作用于同一文本时，两种高亮效果会产生冲突，导致最终的显示效果不符合预期。

技术分析

这个问题源于ModalHistory.vue组件中的双重高亮处理逻辑：

1. 搜索关键词高亮：通过highlightWord函数将匹配的搜索词用HTML span标签包裹，添加特定CSS类
2. SQL语法高亮：通过highlight函数对整个SQL语句进行语法着色

当这两个功能串联使用时（highlight(highlightWord(query.sql))），HTML标签会被当作普通文本处理，而非DOM元素，从而导致标签直接显示。

解决方案

开发团队提供了两种解决思路：

方案一：完全移除搜索高亮功能

直接使用SQL语法高亮，放弃搜索关键词的特殊标记。这种方法简单直接，但牺牲了搜索结果的视觉反馈。

// 修改前
v-html="highlight(highlightWord(query.sql), {html: true})"

// 修改后
v-html="highlight(query.sql, {html: true})"

方案二：调整高亮标记方式

保留搜索高亮功能，但修改标记方式，使用不会与SQL语法高亮冲突的符号：

// 原实现
return string.replace(regexp, '<span class="text-primary text-bold">$1</span>');

// 修改后实现
return string.replace(regexp, '%$1%');

这种方案使用百分号包裹搜索词，既保持了视觉区分度，又避免了HTML标签与语法高亮的冲突。修改后，搜索词会显示为绿色百分号包裹的文本，如%SELECT%。

实现选择与考量

在实际修复中，开发团队需要权衡以下因素：

1. 用户体验：搜索高亮功能对于快速定位结果非常重要，完全移除可能影响使用效率
2. 技术实现复杂度：双重高亮处理需要确保两种高亮机制不会相互干扰
3. 视觉一致性：修改后的高亮样式需要与整体UI风格协调

最终，Antares SQL选择了方案二作为修复方案，因为它：

• 保留了搜索高亮的实用功能
• 解决了HTML标签直接显示的问题
• 通过简单的符号标记实现了足够的视觉区分度
• 避免了与SQL语法高亮的深层冲突

总结

这个案例展示了前端开发中常见的富文本处理挑战，特别是当多个文本处理功能需要叠加时。Antares SQL通过调整高亮标记策略而非完全移除功能，既解决了问题又保持了良好的用户体验，体现了对细节的关注和务实的技术决策。