CodeQuery 技术使用指南

▸ 功能模块架构

[!TIP] 核心组件关系网络
CodeQuery采用"数据处理→交互层→展示层"的三级架构，各模块通过数据库文件实现松耦合协作：

• 数据引擎：makedb/负责将cscope/ctags输出转化为查询库，querylib/提供SQL接口
• 交互中枢：gui/实现Qt界面，scintilla/提供代码编辑能力，lexilla/处理语法高亮
• 可视化层：showgraph/生成函数调用关系图，通过GraphView组件渲染

◈ 模块交互时序

1. 源码经ctags/cscope生成符号表
2. makedb将符号表编译为SQLite数据库
3. querylib执行查询请求
4. gui层通过scintilla展示代码与搜索结果

常见坑点：符号表生成不完整会导致查询结果缺失，需确保ctags版本≥5.8

▸ 操作流程详解

[!TIP] 环境校验清单
⚡ 启动前必做：

1. 确认Qt5/6开发环境（qmake --version）
2. 检查cscope/ctags可执行路径（which cscope ctags）
3. 验证SQLite3开发库（pkg-config --modversion sqlite3）

◈ 数据库构建流水线

# 1. 生成符号文件
ctags -R --c++-kinds=+p --fields=+iaS ./src
cscope -Rbq

# 2. 构建CodeQuery数据库
cd makedb && ./cmakebuild.sh && ./cs2sq myproject.db ../cscope.out ../tags

◈ 图形界面启动

[关键路径] gui/codequery 支持拖放数据库文件直接加载，左侧符号树支持模糊搜索（禁用Exact match时）

常见坑点：Windows下需将cscope.exe/ctags.exe放置于系统PATH目录

▸ 配置要点解析

[!TIP] 场景化配置矩阵

配置项	必要性	开发环境	生产环境	说明
CMakeLists.txt	★★★	需设置Qt路径	禁用DEBUG宏	构建系统核心配置
release.json	★☆☆	版本号管理	自动打包依赖	发布信息描述文件
themes/*.xml	★☆☆	开发调试	用户自定义	代码编辑器配色方案

⚡ 效率提示：通过gui/themes/parse_themes.pl批量转换VSCode主题文件

代码查询主界面，包含符号搜索、代码预览与调用关系导航

展示从源码到可视化查询的完整数据流转过程

常见坑点：自定义主题需遵循XML Schema，否则会导致界面渲染异常