Art of Coding 第10章:避けるべきアンチパターン

この記事は、ブログシリーズ「Art of Coding」全26回のうちの第14回です。前回の記事はArt of Coding 第9章:開発者の共通言語としてのデザインパターンでした。

避けるべきアンチパターン

デザインパターンが長く生きるシステムを築くためのレシピだとすれば、アンチパターンはシステムをじわじわと蝕んでいく習慣です。それは明らかな間違いではありません。わざと悪いコードを書く人はいないのです。アンチパターンとは、そのときは理にかなっているように見えた近道であり、昨日はうまくいった巧妙なハックが、今日には石のように固まって負債と化したものです。

始まりは無邪気なものです。締め切りに間に合わせるための、ちょっとした回避策。リファクタリングには時間がかかりすぎるからと、少しだけ重複させたコード。「あとできれいにする」という約束つきの、あいまいな名前の変数。そして何週間かが過ぎます。チームは大きくなります。そうした近道は固まって、アーキテクチャそのものになっていきます。一時しのぎだったはずのものが恒久的な技術的負債となり、システムが変わっていく力を締めつけていくのです。


なぜアンチパターンが大切なのか

アンチパターンは、単なるコードの臭いではありません—構造についての警告です。善意がプレッシャーの下でどのように腐って負債へと変わっていくのかを、それは教えてくれます。

💡 ポイント: アンチパターンは教訓話です。早い段階でそれを見抜けるようになれば、ほかのチームが陥った過ちをくり返さずにすみます。

何がうまくいかないのかを学ぶことで、問題が広がってしまう前にそれを見つける力が磨かれます。スパゲッティコードのシステムは遅くていらだたしいものですが、少なくとも何かがおかしいことはわかります。では、隠れた副作用と黙ったままの失敗を抱えたシステムはどうでしょう? それは危険です。誰かが気づくまで何週間も、静かに間違った結果を出し続けることがあるのです。

アンチパターンのコストは、時間とともに膨らんでいきます。

  • 保守が遅くなる。 ほかに何が壊れるか予測できないため、どんな変更もリスクが高くなります。
  • オンボーディングがつらくなる。 新しく加わった開発者は、コードを開いた途端に途方に暮れてしまいます。
  • デバッグが探偵仕事になる。 結果が、原因とはまるで無関係に見えるところに現れます。
  • 自信が失われていく。 チームはコードベースを信頼しなくなり、恐れるようになります。

アンチパターンの心理学

アンチパターンを理解するということは、プレッシャーの下での人間の性質を理解するということです。開発者は、絡まり合ったわかりにくいコードをつくろうとしているわけではありません。速く進みたい、機能を届けたい、問題を解決したい。そう思っているだけです。アンチパターンとは、そうした善意が締め切りのプレッシャーや不完全な知識、あるいは単なる物忘れとぶつかったときに生まれるものなのです。

スパゲッティコードは怠慢からではなく、その場しのぎの修正の積み重ねから生まれます。ゴッドオブジェクトは悪意からではなく、すでにあるクラスに「あとひとつだけ責務を」足していく手軽さから育っていきます。隠れた副作用は、誰かが「ついでにキャッシュも自動で更新するようにして、この関数をもっと賢くしよう」と考えたときに忍び込みます。

本書では、悪名高いアンチパターンの数々を探っています。アーキテクチャの絡まり、正しく見えて複雑さを隠してしまう欺瞞的なパターン、そして信頼を損なう沈黙の失敗。しかし、何がうまくいかないのかを並べること以上に、より深い教訓は規律にあります。明日システムが息をできるように、今日「ノー」と言うことです。


傷あとから学ぶ

経験を積んだエンジニアなら誰しも、いっそ焼き払ってしまいたいと思うようなコードベースを引き継いだことがあるはずです。あまりに絡み合っていて、どんな変更も崩壊を招きかねないモノリス。地雷のようにマジックナンバーが散らばったスキーマ。あまりにもろく、誰もが触れるのを恐れるシステム。

こうした話はホラーのように聞こえるかもしれません。けれども、そこには知恵が詰まっています。何をしてはいけないのかを教えてくれるのです。それは多くの場合、何をすべきかを知ること以上に価値があります。そして何よりも力強い教師となるのは、二度とくり返さないと誓ったアンチパターンが残していった傷あとであることが多いのです。

⚠ 注意: アンチパターンが自ら名乗り出ることはめったにありません。理にかなった判断という仮面をかぶっているのです。唯一の防御策は、注意を怠らないこと、そしてそれがどんな姿をしているのかをチームで共有しておくことです。

本書では、具体的なアンチパターン—あなたが最も出会いやすいもの—と、他人の過ちをくり返そうとしているときに警告を発してくれる文化的・技術的なサインについて、さらに掘り下げています。ここでは明かしませんが、これだけは言っておきます。アンチパターンがシステムの中で固まってしまう前にそれを見抜くことは、開発者が身につけられる最も価値あるスキルのひとつです。

→ シリーズの次の記事: 第11章:アーキテクチャ的思考
どのアンチパターンがあなたのコードベースを静かに劣化させているのか、そしてそれが広がる前にどう見抜けばよいのかを知りたい方は、『The Art of Coding: Philosophy and Practice for the Age of AI』(英語版)をAmazonでお求めいただけます。
2026-01-05

下田 昌平

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