【ITニュース解説】just nuked 120+ unused npm deps from a huge Nx monorepo

ソフトウェア開発の世界では、様々な機能を持つ外部のライブラリやモジュールを組み合わせてアプリケーションが作られる。これらは「依存関係」と呼ばれ、プロジェクトを動かすために必要不可欠な部品だ。今回紹介するニュースは、そんな依存関係の管理がいかに重要か、そしてどのように効率的に行うかを示している。

ある大規模な開発プロジェクトで、実際には使われていない依存関係が120個以上も見つかり、それが原因で開発効率が低下していた。この問題を解決するため、専門ツール「Knip」を導入し、不要な依存関係を削除したところ、プロジェクトの初期設定に必要な「yarn install」というコマンドの実行時間が1分も短縮されたという話だ。

まず、「依存関係」について詳しく見てみよう。JavaScriptを使ったウェブアプリケーション開発では、「npm（Node Package Manager）」というツールが非常に広く使われている。これは、世界中の開発者が作った便利な機能やライブラリ（これらを「パッケージ」と呼ぶ）を、自分のプロジェクトに簡単に追加できるようにする仕組みだ。例えば、日付を扱うパッケージ、データを通信するパッケージ、ユーザーインターフェースを作るパッケージなど、数えきれないほどのパッケージが存在する。

プロジェクトを開発する中で、新しい機能を追加したり、実験的に様々なライブラリを試したりすると、必然的にこれらのパッケージがプロジェクトに追加されていく。しかし、時には試しただけで使わなくなったパッケージや、機能変更によって不要になったパッケージが、そのままプロジェクトに残されてしまうことがある。これらが「未使用の依存関係」だ。

未使用の依存関係がたくさんあると、いくつかの問題が発生する。一つは、プロジェクトを始める際に必要な「インストール」作業の時間が長くなること。たくさんの不要なファイルをダウンロードし、設定するため、開発者はその分待たされることになる。今回のニュース記事では、「yarn install」というコマンドの時間が1分短縮されたとあるが、「yarn」も「npm」と同様にパッケージのインストールを管理するツールの一つだ。開発者が毎日何度もこの作業を行うとすれば、1分でも積み重なれば大きな時間のロスとなる。また、プロジェクトのファイルサイズが肥大化したり、セキュリティ上のリスクが増えたり、コードの保守が難しくなるといった問題も引き起こす。

今回のプロジェクトは「Nxモノレポ」と呼ばれる環境で開発されていた。「モノレポ（Monorepo）」とは、「単一のリポジトリ」という意味で、複数の独立したアプリケーションやライブラリのコードを、一つの大きなバージョン管理システム（Gitなど）でまとめて管理する開発手法のことだ。例えば、ウェブサイト、スマートフォンアプリ、バックエンドAPIなど、異なるが関連性の高い複数のプロジェクトを一つのリポジトリに格納する。モノレポには、コードの再利用が容易になったり、一貫した開発環境を保ちやすくなるといったメリットがある一方で、プロジェクト全体が巨大になりがちで、依存関係の管理が複雑になるという課題も抱えている。

「Nx」は、このようなモノレポ環境での開発を強力にサポートするためのフレームワークだ。複数のアプリケーションやライブラリ間の依存関係を効率的に管理したり、ビルド（コードを実行可能な形式に変換する作業）やテストを最適化したりする機能を提供する。巨大なモノレポでは、どのパッケージがどのアプリケーションで使われているかを把握するのが非常に難しくなるため、未使用の依存関係が溜まりやすい傾向にある。

そこで登場するのが「Knip」というツールだ。Knipは、JavaScriptやTypeScriptのプロジェクトを分析し、コードの中で実際に使われていないパッケージやファイルを検出する役割を持つ。Knipはプロジェクト内のすべてのコードを解析し、依存関係の定義ファイル（例えばpackage.json）に記述されているパッケージのうち、実際にコード内でimport（読み込み）されていないものを特定する。今回の事例では、このKnipを使うことで、長年蓄積されてきた120個以上の未使用の依存関係を特定し、削除することができたのだ。

しかし、ツールが未使用と判断したものが、実は間接的に使われていたり、特定の条件下でだけ使われたりする場合がある。これを「誤検知（false positive）」と呼ぶ。例えば、設定ファイルやビルドスクリプトの中で参照されているパッケージが、コードからは直接importされていないために、Knipが未使用と判断してしまうケースがある。もし誤って必要なパッケージを削除してしまうと、アプリケーションが正常に動作しなくなる恐れがある。そのため、記事では「誤検知の回避方法」についても言及されており、ツールが出力したリストを鵜呑みにせず、慎重に確認するプロセスが重要であることを示唆している。

このようにして未使用の依存関係を削除した結果、最も顕著な効果として表れたのが、「yarn install」の実行時間が1分短縮されたことだった。これは開発者の作業効率向上に直結する大きな改善だ。開発サイクルの中で、ビルドやテスト、デプロイといった様々な工程で依存関係が関係してくるため、基盤となるインストール時間の短縮は、プロジェクト全体のスピードアップに貢献する。

このニュースは、ソフトウェア開発において、コードそのものの品質だけでなく、プロジェクトを取り巻く環境やツール、そして依存関係の管理がいかに重要かを示している。特に大規模なプロジェクトやモノレポのような複雑な環境では、定期的なクリーンアップと、それを助ける適切なツールの導入が、開発の健全性を保ち、効率を高める上で不可欠となる。システムエンジニアを目指す上で、このようなプロジェクト管理や効率化の側面を理解し、実践する能力は非常に価値があると言えるだろう。