Art of Coding 第6章:抽象化とモジュール化

この記事は、ブログシリーズ「Art of Coding」全26回のうちの第9回です。前回の記事はArt of Coding 第III部:良いコードを形づくる実践でした。

壁のない家

以前、手がつけられないほど膨れ上がったプロジェクトをレビューしたことがあります。かつては美しかったコアロジックが、特殊ケースと隠れたルールの寄せ集めになっていました。新しい機能をひとつ追加するだけで、互いに関係のないファイルを五つも六つも触らなければならない。もはや、単独で成り立っているものは何ひとつありませんでした。

それを見て、壁のない家を思い出しました。キッチンはリビングに溶け込み、寝室はガレージにつながっている。最初のうちは、それでも暮らせます。けれども客が来たり、改装が必要になったりした途端、境界がないせいで何もかもが立ち行かなくなるのです。

抽象化もモジュール化もないままコードが育つと、こうなります。動きはするかもしれません。でも、息ができないのです。


なぜ境界が大切なのか

💡 ポイント: 抽象化は複雑さを隠し、より高い視点で考えられるようにしてくれます。モジュール化は境界を引き、責務をはっきりさせます。この二つがそろってはじめて、しなやかに曲がっても折れないシステムが生まれます。

本書では、コードが混乱ではなく明快さを増しながら成長していくための形づくり方を探っています。実践の場では、次のような意味を持ちます。

関数、クラス、モジュールを正しくつくる。 千行にも及ぶ関数は、ただ読みにくいだけではありません—壊れやすいのです。ちょっとした変更のたびに、目に見えない何かを壊す危険があります。良い関数とは、小さくまとめられたひとつの考えです。良いクラスとは、明確な役割をひとつだけ持った登場人物です。良いモジュールとは、それぞれに目的を持った家の中の部屋です。

DRYとTMAのせめぎ合い。 「同じことをくり返すな(Don't Repeat Yourself)」は賢明な教えですが、絶対ではありません。似ているのが本質的なのか、たまたまなのかを見極める前に、早すぎる共通化で柔軟性を失ってしまったチームを私は何度も見てきました。過剰な抽象化(Too Much Abstraction)は、重複よりもたちが悪いことがあります。いつ共通化し、いつ待つべきかについては、本書でさらに掘り下げています。

契約としての境界。 良いインターフェースはこう語ります。「期待してよいのはこれです。それ以上でも、それ以下でもありません。」明確な境界があれば、変更が連鎖することなくシステムを進化させられます。境界がなければ、どんな小さな変更も思いがけないところへ波及していきます。


AIと構造

AIは関数やクラスを数秒で生成できます。しかし、どこに継ぎ目を置くべきかを自然に理解しているわけではありません。放っておけば、関心事を混ぜ合わせ、責務をあいまいにし、ロジックをあちこちに散らばらせてしまいます。人間の役割は、壁を立て、扉をどこにつけるかを決め、機械が生み出したものを正しい部屋に住まわせることです。

⚠ 注意: 抽象化しすぎることは、抽象化が足りないことと同じくらい確実にシステムを殺します。本書では、その違いを見分ける方法と、控えることこそが知恵である場面について解説しています。
→ シリーズの次の記事: 第7章:エラー処理と回復力
詳しく知りたくなりましたか? 本章の全文では、拡張性のあるモジュールを築くための実践的なパターン、柔軟性を締めつけないDRYの考え方、そしてチームが本当に使いたくなるインターフェースの設計方法を詳しく紹介しています。本書の全文はAmazonでお読みいただけます(英語版)。
2025-12-31

下田 昌平

開発に関するインプットをアウトプットしています。