如何将JDoc文档迁移至其他分支（或保留JDoc回滚代码变更）

以下几种方法可以帮你把JDoc注释单独分离到干净的分支或PR中：

1. Git差异过滤提取JDoc #

直接通过Git命令对比修改分支与原始分支的差异，过滤出仅包含JDoc的内容：

git diff 原始分支名 你的JDoc分支名 | grep -A 20 -B 2 '/\*\*'

这个命令会提取所有以/**开头的注释块及前后少量上下文，你可以把这些内容整理后，手动对应到原始代码的方法/字段上方。

2. 脚本自动迁移JDoc #

写个简单的脚本（比如Python或Shell）来批量提取和插入注释：

• 遍历修改后的Java文件，解析出每个方法、字段上方的JDoc注释，记录对应的元素名称（比如方法名volgendWachtwoord）
• 再遍历原始代码文件，根据元素名称找到对应位置，插入对应的JDoc注释
  这种方法适合注释量很大的场景，能节省手动复制的时间。

3. 重建干净的JDoc分支 #

最稳妥的手动方式：

• 切换到原始分支：git checkout 原始分支名
• 创建新的干净分支：git checkout -b 纯JDoc分支名
• 打开修改后的分支代码，逐个把JDoc注释复制到原始分支对应方法/字段的上方
• 仅提交注释变更，这样你的PR就只会包含JDoc内容，没有格式化或导入的改动

4. IDE对比工具迁移注释 #

用IntelliJ IDEA或Eclipse的文件对比功能：

• 同时打开原始代码文件和修改后的代码文件
• 利用IDE的差异高亮，只选中JDoc注释块复制，粘贴到原始文件的对应位置
• 保存后提交即可，IDE的对比能帮你快速定位到每个需要加注释的元素位置

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