はじめに

・処理の流れは追えるのに、途中で止まってしまう人へ

コードを追っていて、

👉 処理の流れはなんとなく分かる

でも、

👉 この中で何をしているのか分からない

こんな状態になったことはありませんか？

例えば、

var result = service.Execute(data);

👉 「何か処理してるのは分かる」

でも

👉 Executeの中で何をしているのか分からない

👉 だから手が止まる

※この記事でいう「メソッド」は、処理のまとまり（関数や処理単位）のことを指しています

よくある状態

こういうとき、多くの人はこうなります。

・とりあえず中身を開く
・さらに別のメソッドに飛ぶ
・また別のクラスへ

👉 気づいたら

👉 何を理解しようとしていたのか分からなくなる

👉 これも一種の“迷子”です

なぜ分からなくなるのか

原因はシンプルです。

👉 処理だけを見ているから

多くの人は、

👉 「このメソッドは何をしているのか？」

と考えます

👉 でもこれだけでは分かりません

「要件や設計が分からないから？」と思う人へ

ここで、こう思った方もいるかもしれません

--
👉 「要件が分かってないからでは？」
👉 「設計を理解していないからでは？」

これは、

👉 半分正しくて、半分違います

コードが理解できない原因は、大きく3つあります

・要件が分かっていない（なぜその処理をするのか）
・データが分かっていない（何がどう変わるのか）
・設計が分かっていない（どこで何をしているのか）

このうち、

要件や設計は確かに重要ですが、

👉 ドキュメントや経験に依存することが多く、
すぐに理解できるものではありません

一方で、

👉 データの動きはコードから追うことができます

つまり、

👉 「意味が分からない」と感じたときにまずやるべきことは

👉 データを見ることです

飛べば分かるのでは？

ここでこう思うかもしれません

👉 「メソッドの中に飛べば分かるのでは？」

確かに、

👉 処理の流れは分かるようになります

でも、

👉 それだけでは意味は分かりません

具体例（ここがポイント）

例えば、

var rate = GetRate(user);

👉 「何か計算しているのは分かる」

中を見ると、

return user.Level == 3 ? 0.8 : 1.0;

👉 コードは読めます

でも、

・Level=3って何？
・なぜ0.8になる？

👉 意味は分かりません

では、どうすればいいか？

👉 見るべきは「処理」ではなく「データ」です

例えば、

・user.Level はいくつなのか？
・Level=3 はどういう状態なのか？
・rate は最終的にいくつになるのか？

👉 つまり

👉 どんな値が入ってきて、どう変わるのかを見る

これを整理すると、

👉 見るべきポイントは3つです

👉 入力 → 変化 → 出力

シンプルな例で確認

public int Calculate(int price)
{
    return price * 1.1;
}

👉 入力：price
👉 変化：1.1倍
👉 出力：結果

👉 この見方で、すべてのコードは理解できます

なぜこれで分かるのか

👉 コードはすべて

👉 データを加工しているだけ

👉 だから

👉 データを見れば意味が分かる

よくある詰まりポイント

■ 抽象化された処理

service.Execute(data);

👉 中身が隠れている

■ 条件分岐

if (CheckCondition(user))

👉 判断基準が分からない

■ 非同期処理

await repository.SaveAsync(entity);

👉 どこでどう処理されているか分からない

👉 これらすべて

👉 データを見ていないことが原因

解決方法

👉 これだけです

Step① 入力を見る

👉 何が渡ってきているか

Step② 変化を見る

👉 値がどう変わるか

Step③ 出力を見る

👉 何が返るか

👉 この3つで理解できます

まとめ

👉 メソッドの中身が分からない原因は

👉 処理だけ見ていること

👉 解決はこれ

👉 データを見る

✔ 1つだけ覚えるなら

👉 「入力 → 変化 → 出力」

おわりに

今回の内容は、

👉 「流れは追えるけど理解できない人」向けでした

もし、

・どこから見ればいいか分からない
・処理を追っていて迷子になる
・仕様書とコードが繋がらない

といった段階でつまずいている場合は、

👉 まずは以下の記事から読むと理解しやすくなります

■ シリーズ記事

新人・初級PGが最初につまずくポイント5選
なぜ仕様書とコードは繋がらないのか
仕様書は読めるのにコードにできない人へ
ソースは読めるのに処理が追えないのはなぜ？
どのソースを見ればいいか分からない人へ

■ 最後に

ここまで紹介した方法は、

👉 1回やれば終わりではありません

これを繰り返していくことで、

・フォルダ構成
・処理の配置
・データの流れ

👉 全体像が少しずつ見えてきます

そして、

👉 最初から目的の場所に辿り着けるようになります

最初は、

👉 「分かる場所から辿る」
👉 「データを見る」

これを繰り返すことが大切です

👉 この積み重ねが

👉 「なんとなく分かる」から
👉 「ちゃんと分かる」へ

変わっていきます