如何在JQAssistant命令行中正确使用git插件采集Git信息

jqassistant.sh scan -f .git命令无法采集Git信息的核心原因是：-f参数会将传入路径作为普通文件系统对象扫描，不会触发Git插件的专属解析逻辑，按以下步骤配置即可正常采集Git结构化数据：

插件安装校验 #

仅放入org.eclipse.jgit jar包无法满足运行要求，需同时将对应版本的jQAssistant Git插件jar包放入程序的plugins目录，且保证引入的org.eclipse.jgit jar版本不低于4.8.0.201706111038-r，插件包与JGit依赖包版本兼容。

正确扫描命令 #

进入目标Git仓库的根目录（即.git文件夹的上级目录），执行以下命令启动扫描：

jqassistant.sh scan -u git:scope

如果需要扫描非当前工作目录下的Git仓库，可追加路径配置参数指定目标仓库位置：

jqassistant.sh scan -u git:scope -Dgit.uri=file:///目标仓库的本地绝对路径

结果验证 #

扫描完成后可通过内置Cypher查询校验采集结果，执行以下语句统计已采集的提交数量：

MATCH (c:Git:Commit) RETURN count(c)

返回值大于0即代表提交记录、分支、作者、标签等Git信息已正常采集入库。

注意事项 #

• 执行扫描命令的系统账号需拥有目标Git仓库的完整读权限，否则无法读取Git对象文件，会出现采集结果为空的问题
• 扫描时无需传入-f .git参数，该参数会强制走普通文件扫描流程，跳过Git插件的解析逻辑

内容的提问来源于stack exchange，提问作者hmozaffari