ChangePrism：让代码变更可视化更精准，洞察代码演化本质

论文信息

• 论文原标题：ChangePrism:Visualizing the Essence of Code Changes
• 主要作者及研究机构：
  • Lei Chen，东京理科大学计算学院（School of Computing, Institute of Science Tokyo, Japan）
  • Michele Lanza，瑞士卢加诺USI软件研究所REVEAL实验室（REVEAL @ Software Institute - USI, Lugano, Switzerland）
  • Shinpei Hayashi，东京理科大学计算学院（School of Computing, Institute of Science Tokyo, Japan）
• 引文格式（APA）：Chen, L., Lanza, M., & Hayashi, S. (2025). ChangePrism: Visualizing the Essence of Code Changes. arXiv:2508.12649v1 [cs.SE].

一段话总结

本文提出了一种名为ChangePrism的新型代码变更可视化工具，旨在解决传统代码diff工具仅通过红绿标记增减内容，无法区分不同变更类型、缺乏整体视图等问题。该工具包含提取和可视化两个组件，能从Git历史中获取代码变更信息，通过概览视图、提交洞察视图和代码细节视图，以不同颜色标记重构、微变更等多种变更类型，帮助开发者更全面、高效地理解代码提交中的变更内容、位置和类型。

思维导图

研究背景

在软件维护和演化过程中，理解开发者提交的代码变更是至关重要的环节。传统方式依赖于查看代码diff，用红色和绿色分别标记代码的删除和添加。

但这种方式存在明显不足。比如，当一个提交涉及多个文件的变更时，开发者很难快速把握变更的整体规模；而且它无法区分不同类型的变更，像代码修改、重构和微变更等，这可能导致开发者忽略重要的细节。就好比整理一堆杂乱的文件，只知道哪些文件被拿走、哪些被新增，却不清楚文件内容是简单修改还是结构上的大调整，很难高效地理解整体情况。

创新点

1. 精准区分多种变更类型：首次将代码变更细分为添加、删除、修改、重构（细分为类级、方法级、语句级）和微变更，并为每种类型赋予独特的颜色标识。
2. 多层次视图展示：提供概览视图、提交洞察视图和代码细节视图，从整体到局部全方位展示代码变更，满足不同层次的理解需求。
3. ChangeSpectrum创新设计：通过包含两个迷你地图的ChangeSpectrum，直观展示文件在提交前后的代码变更位置和类型，帮助开发者快速定位关键变更。
4. 支持筛选功能：用户可通过复选框筛选想要查看的变更类型，聚焦重点内容，减少认知负担。
   

研究方法和思路、实验方法等

研究方法和思路

1. 数据提取：
   • 利用java-diff-utils库提取代码的添加、删除和修改三种基本变更类型。
   • 借助RefactoringMiner工具提取重构类型的变更。
   • 通过微变更检测器提取微变更类型的代码变更。
   • 提取的结果包含变更类型名称及其对应位置，作为可视化组件的输入。
2. 可视化设计：
   • 概览视图：展示提交历史时间线，每个提交以蓝色圆圈表示，可查看单个提交的基本信息、变更文件及对应的ChangeSpectrum，支持进入其他视图。
   • 提交洞察视图：呈现单个提交中每个变更文件的ChangeSpectrum，帮助用户把握该提交中变更的整体范围和影响。
   • 代码细节视图：展示具体的源代码及变更，用不同颜色高亮显示各类变更，鼠标悬停可查看重构和微变更的具体类型。

实验方法

以mbassador仓库的一个提交为例进行案例研究。该提交仅涉及ListenerFactory.java一个文件的变更，通过ChangePrism的各个视图展示该文件的变更情况，包括新增的Javadoc注释、各类重构（如添加属性修饰符、添加方法修饰符）和微变更等，验证工具的有效性和实用性。

主要贡献

开源信息：论文中未提及开源的代码或数据集，仅提供了视频演示链接：https://youtu.be/jMoGLfM3KIM。

关键问题

1. 问：传统代码diff工具存在哪些问题？答：仅用红绿标记增减内容，无法区分不同变更类型，缺乏整体视图，难以让开发者全面、快速地理解代码变更的规模和重要细节。
2. 问：ChangePrism由哪些核心组件构成？答：主要由提取组件和可视化组件构成，提取组件从Git历史中获取代码变更及相关信息，可视化组件提供三种不同视图展示变更。
3. 问：ChangeSpectrum在ChangePrism中起到什么作用？答：它是一种简洁的可视化表示，包含两个分别对应提交前后文件的迷你地图，按比例展示文件长度，用不同颜色分层表示各类变更，帮助用户快速了解变更文件中变更的类型、位置和规模。
4. 问：ChangePrism如何区分不同类型的重构？答：用三种不同深浅的蓝色区分，浅蓝色表示类级重构，蓝色表示方法级重构，深蓝色表示语句级重构。
5. 问：ChangePrism的未来发展计划有哪些？答：包括增强用户界面（添加搜索和导航功能）、提高高亮准确性、支持更多变更类型、与GitHub和审查平台集成等。

总结

本文提出的ChangePrism是一款创新的代码变更可视化工具，针对传统代码diff工具的不足，通过提取Git历史中的代码变更信息，以多视图和颜色编码的方式展示包括重构、微变更在内的多种变更类型。它为开发者提供了从整体到细节的代码变更理解途径，有助于提升软件维护和演化的效率。未来，该工具还将在用户界面、准确性、功能扩展和平台集成等方面进行改进。