クリーンコード とは？

一言で言うと「他の人（や未来の自分）が読んでもすぐ理解できるコード」のことだよ。たとえば変数名が「x」や「data2」じゃなくて「userAge」や「orderTotal」になっている。関数も1つの処理だけをする小さな単位に分かれている。コメントがなくてもコード自体が説明書になっているイメージだね。

プログラマーの時間の約8割は「既存のコードを読む」ことに使われていると言われているんだ。書くのは一瞬でも、そのコードは何年も読まれ続ける。だから読みやすさへの投資は長期的に見て圧倒的にコスパがいいんだよ。

まずは「意味のある名前をつける」ことと「関数を短く保つ」ことから始めるといいよ。ただし注意したいのは、クリーンコードの原則を教条的に守りすぎると逆に過度な抽象化や細分化で読みにくくなること。「このコードを初めて読む人が理解するまでにどれくらいかかるか」を常に意識するのが一番大事だよ。

「ボーイスカウトルール（来たときよりも美しく）」が実践的だよ。一度にリファクタリングしようとせず、触ったファイルを少しだけ綺麗にして戻す。まずテストを書いてから安全にリファクタリングする「レガシーコード改善ガイド（Working Effectively with Legacy Code）」の手法がバイブルだね。実は「技術的負債」という概念を提唱したウォード・カニンガムは、「負債は意図的に受け入れるもの」と言っていて、すべてのコードを完璧にする必要はないんだ。返済計画を持つことが大事なんだよ。