正文
环境:
-
Qoder IDE(macOS)
-
工作区:Java 多模块 Maven 工程(约 1000 个 Java 文件)
问题描述: 执行 repowiki 知识库更新后,除了预期的 .qoder/repowiki/** 文档变更外,工作区内 927 个 Java 源文件被意外修改——所有文件的 Javadoc 注释被批量删除(约 21,700 行),另有少量缩进被重排。
证据:
-
提交统计:
949 files changed, 370 insertions(+), 21780 deletions(-)(其中.qoder/repowiki文档为正常变更,其余全部为 Java 源文件) -
对 Java 部分 diff 逐行分析:被删除的 21,673 行全部为注释(
/** ... */、@author/@date文件头、方法 Javadoc),非注释删除仅 14 行且均为缩进对调 -
典型示例:
-/**
- * 优惠算价, 不依赖缓存
- * @param request
- * @return
- */
@ApiOperation("优惠算价,商品添加")
@PostMapping(PATH + "/calcOnAddItem")
预期行为: Repowiki 知识库生成对用户源码应该是只读的,任何情况下都不应修改源文件内容。
实际影响:
-
源码注释资产丢失
-
变更被裹挟进提交后合入集成分支,与其他并行分支产生 900+ 文件的大面积合并冲突
-
只能通过
git revert恢复,成本高