不安定なインターフェース
ID: unstable_interface | 重要度: Medium (default)
git の履歴に基づき、公開 API(エクスポート)が頻繁に変更されている一方で、他の多くのモジュールから依存されているモジュールを特定します。
なぜこれが「不吉な臭い」なのか
不安定なインターフェースは波及効果を引き起こします。インターフェースが変更されるたびに、その全ての依存先を更新する必要がある可能性があり、多大な定型業務と潜在的なバグにつながります。
修正方法
- API を安定させる: 実装前にインターフェースの設計により多くの時間を費やしてください。
- バージョニングを使用する: 可能であれば、移行期間中にインターフェースの複数のバージョンを同時にサポートします。
- インターフェースを狭める: 絶対に必要なものだけをエクスポートします。