【エンジニアあるある】「このコード誰が書いたの？」と思ったら自分だった

2025年1月16日

こんばんは！IT業界で働くアライグマです！

ソフトウェア開発に携わるエンジニアであれば、一度は体験したことがあるであろうこの現象。「誰がこんなコードを書いたんだ？」と思いながら調べた結果、自分だったというオチ。最初は驚きや恥ずかしさを感じるかもしれませんが、この経験こそエンジニアとしての成長やプロジェクト管理の重要性を学ぶ絶好の機会です。

本記事では、この「エンジニアあるある」を深掘りし、なぜこうした状況が発生するのか、その背景を探りつつ、再発防止のための実践的なアプローチを詳しく解説します。

Contents

1. なぜ「自分のコードを他人のように感じる」のか？
2. 「このコード誰が書いたの？」を防ぐためのアプローチ
3. 「自分のコードに驚く経験」を成長の糧にする
4. まとめ

なぜ「自分のコードを他人のように感じる」のか？

技術的スキルの成長

エンジニアとしての成長が進むにつれ、過去のコードに対する見方が変わります。新しい設計パターンやコーディング規約を学び、以前は問題ないと思っていた部分が「改善すべき点」に見えるようになるのです。この変化はポジティブな成長の証拠です。

時間経過による忘却

プロジェクトが進行する中で、多くのコードを書き換えたり、新しいタスクに取り組んだりすることで、数週間前、あるいは数か月前に書いたコードの記憶が薄れていきます。特に、コードに十分なコメントが残されていない場合、この忘却現象は顕著です。

急ぎの実装や技術的負債

納期のプレッシャーやプロジェクトの要件変更に追われる中で書かれたコードは、長期的なメンテナンス性よりも短期的な実現可能性を優先して書かれることが多いです。その結果、「一時的なつもりで書いたはずのコード」が後々問題を引き起こすことがあります。

チーム開発での齟齬

チームメンバーが異なるコーディングスタイルや命名規則を使用していると、全体として一貫性のないコードベースが生まれることがあります。その中で自分のコードを見失うことも。

「このコード誰が書いたの？」を防ぐためのアプローチ

過去の自分のコードに驚く経験を減らすために、以下のような工夫を日々の開発プロセスに取り入れてみましょう。

わかりやすいコードを書く

「コードは他人のためではなく、未来の自分のために書く」という格言があります。以下の点に注意して、わかりやすいコードを書く習慣をつけましょう。

命名規則を統一
変数や関数名に、具体的かつ明確な名前を付けることで、コードの意図がすぐに伝わるようにします。例えば、tmpやdataではなく、userDetailsやorderSummaryなど、役割がわかる名前を使用します。
コードを簡潔に保つ
1つの関数やメソッドに多くの責務を持たせないようにします。「単一責任の原則」を意識して、読みやすさを維持しましょう。

コメントを適切に活用

コードにコメントを残すことで、未来の自分や他の開発者がコードの意図を理解しやすくなります。ただし、コメントの内容は簡潔かつ要点を絞ったものでなければなりません。

// ユーザーのログイン状態をチェックする関数
function isUserLogined($userId) {
    // データベースからログイン状態を取得
    $userData = getUserData($userId);
    return !is_null($userData);
}