Three Code‑Reading Assistance Tools: Source Insight, Understand, and Sourcetrail

1. Introduction

Programmers often say, "Talk is cheap, show me the code!" because source code conveys the most concrete information about a program, making code reading an essential skill for both beginners and seasoned developers when learning open‑source projects or refactoring legacy code. In increasingly complex and fast‑moving business contexts, improving the efficiency of code navigation can significantly boost developer productivity and create business value.

Just as a craftsman needs good tools, code reading can be accelerated with specialized utilities; this article presents three such code‑reading assistance tools for you to try in your workflow.

2. Tools

2.1 Source Insight

Source Insight (SI) employs static code analysis to present multi‑dimensional analysis results, aiding code reading, rapid search, inspection, and formatting. It runs only on Windows; macOS users must use a virtual machine.

① Code Visualization : provides various graphical views such as inheritance diagrams and CallGraph.

Inheritance diagram:

CallGraph:

② Code Inspection : checks syntax, formatting, and style.

④ Code Exploration : shows where functions and variables are used, with advanced search across the whole project.

⑤ Comparison Analysis : offers multi‑dimensional file and directory comparison.

File comparison:

Directory comparison:

Other features are available for interested users to explore.

2.2 Understand

Understand also uses static analysis, offering richer multi‑dimensional results and better usability, and it supports multiple operating systems.

① Code Visualization : provides dependency graphs, CallGraph, control‑flow graphs (CFG), UML diagrams, etc.

Control‑flow graph (CFG):

UML diagram:

More visualizations are listed under "Interesting Graphs about Your Code".

② Code Inspection : applies industry or custom standards to ensure safety, cleanliness, and usability.

③ Code Quantification : measures metrics such as cyclomatic complexity and metric trees.

Metric charts provide project‑wide insights, highlighting the most complex or largest functions, classes, and files.

④ Code Exploration : simplifies complex code relationships with convenient search, allowing rapid location of identifiers, inspection of function signatures, class members, and visual butterfly graphs for call relationships.

⑤ Code Change Analysis : quickly view differences between two code bases, filtering by file, folder, entity, or architecture, using either text or tree visualizations.

Other features are available for curious users to explore.

2.3 Source Trail

Sourcetrail is a free, open‑source, cross‑platform source analysis tool that visualizes function call chains as mind‑maps, offering an elegant graphical interface to explore identifiers and linkage within a project.

Note: the project stopped maintenance in 2021, and the macOS version still suffers from an unresolved Java initialization issue ("Sourcetrail was unable to locate Java on this machine").

3. Summary

Tool Name

Feature Richness

Ease of Use

Cost

Supported OS

Maintenance

Source Insight

⭐️⭐️⭐️⭐️

⭐️⭐️

High

Windows

No new features for a long time

Understand

⭐️⭐️⭐️⭐️⭐️

⭐️⭐️⭐️⭐️⭐️

High

Windows/Linux/macOS

Active

Source Trail

⭐️⭐️

⭐️⭐️⭐️⭐️

Free

Windows/Linux/macOS

Stopped in 2021

If you have never used similar software, we recommend trying Understand first.

4. References

【Tool Mastery】Essential Tools Part 1 – Source Insight

What is the best code‑reading or editing tool you have used?

12 Greatest Code Visualization Tools for Developers

Code visualization: How to turn complex code into diagrams