いまさら Knip を知った。未使用コード削減がめちゃくちゃ捗る

TL;DR

Knip は JavaScript / TypeScript プロジェクトの未使用ファイル、未使用 dependencies、未使用 exports を見つけてくれるツール。
ESLint が拾いにくい「プロジェクト全体で誰からも参照されていないもの」を洗い出せるのが強い。
Next.js、Vitest、Storybook、Vite、Nx などのツール向けプラグインもあり、現代フロントエンドの構成にかなり寄り添っている。
いきなり削除ではなく、まずレポートを眺めて、小さい PR で掃除していくのがよさそう。

Knip というツールをいまさら知った。

正直、最初は「未使用コード検出？ ESLint と TypeScript でだいたい見えるのでは？」くらいに思っていた。
でも違った。Knip が見ているのは、ファイル単位、依存パッケージ単位、export 単位の「もう誰も使っていないかもしれないもの」だ。

こういうやつ。

こういう死蔵コードは、1個1個は小さい。
ただ、積もると「このファイル消していいんだっけ？」の判断コストとして効いてくる。

一番いいと思ったのは、見る単位がプロジェクト全体なところ。

ESLint はファイル内の未使用変数や未使用 import を見つけるのが得意だ。
一方で、ある export がプロジェクトのどこからも使われていないか、あるファイルがエントリポイントから辿られないか、package.json の依存が本当に必要か、みたいな話は別のレイヤーになる。

Knip はそこを見てくれる。

公式サイトでも、Knip は unused dependencies、exports、files を見つけて修正できるツールとして説明されている。さらに、フレームワークや周辺ツールの entry point を踏まえて解析するため、単純な grep より実用に寄っている。

特にいいなと思ったのは、プラグインの多さ。
執筆時点の公式ドキュメントでは、Next.js、Vitest、Jest、Storybook、Vite、Webpack、Nx、Remix、Svelte、GitHub Actions などを含む約150個のプラグインがあると紹介されていた。

この手のツールは「設定ファイルや CLI からだけ参照されるもの」を誤検知しがちだけど、主要ツールの慣習を知っているのはだいぶありがたい。

導入はかなり軽い。

npm init @knip/config
npm run knip

既存プロジェクトに入れず試すだけなら、次でもいける。

npx knip

Knip v6 は Node.js v20.19.0 以上、または Bun が必要とのこと。
Node.js のバージョンが古いプロジェクトでは、そこだけ先に確認したほうがいい。

出力が多すぎる場合は、まず件数を絞る。

npm run knip -- --max-show-issues 5

最初から全部直そうとすると疲れる。
まず「これは確実に消せる」というものだけ拾うのがよさそう。

Knip はかなり強いけど、レポートに出たものを脳死で全部消すのは危ない。

個人的には、次の順で見るのが扱いやすいと思った。

特に exports は注意したい。
アプリケーション内部の export なら消しやすいけど、ライブラリや公開 API の export は「このリポジトリ内では未使用」でも外部利用があるかもしれない。

なので、最初は internal なアプリや閉じたパッケージから始めるのがよさそう。

未使用コードを減らすメリットは、単に行数が減ることだけではない。

最後のやつが地味に大きい。
AI にコードを書かせるほど、リポジトリ内に残った古い実装や未使用パターンがノイズになる。

人間にとっても AI にとっても、使われていないコードは「読めるけど信じていいかわからない情報」だ。
Knip はそこを掃除するきっかけをくれる。

Knip、マジ神。

いまさら知ったけど、これはもっと使われていいと思う。
JavaScript / TypeScript のプロジェクトで、未使用ファイル、未使用依存、未使用 export が気になっているなら、とりあえず一回 npx knip してみる価値がある。

削除は慎重に。
でも、見える化は今すぐやっていい。