Skip to content

不安定なインターフェース

ID: unstable_interface | 重要度: Medium (default)

git の履歴に基づき、公開 API(エクスポート)が頻繁に変更されている一方で、他の多くのモジュールから依存されているモジュールを特定します。

なぜこれが「不吉な臭い」なのか

不安定なインターフェースは波及効果を引き起こします。インターフェースが変更されるたびに、その全ての依存先を更新する必要がある可能性があり、多大な定型業務と潜在的なバグにつながります。

修正方法

  • API を安定させる: 実装前にインターフェースの設計により多くの時間を費やしてください。
  • バージョニングを使用する: 可能であれば、移行期間中にインターフェースの複数のバージョンを同時にサポートします。
  • インターフェースを狭める: 絶対に必要なものだけをエクスポートします。

Released under the MIT License.