yarn 1 · ビルドと型
メッセージ
The engine "node" is incompatible with this module. Expected version ">=20"
何を意味するか
入れようとしているパッケージが package.json の engines に必要な node の版を書いており、今使っている版がその範囲の外だという意味です。後ろに付く Expected と Got が要求範囲と自分の版を並べて見せるので、その二行だけ見れば足ります — CI でだけ出るなら、そこの node の版が自分の環境と違うということです。nvm install 20 && nvm use 20 で node を上げるのが正面の答えで、.nvmrc や CI の設定にも同じ版を書いておけば次にまたずれません。yarn の --ignore-engines で押し通せますが、それは警告を消すだけで互換性を作らないので、そのパッケージが新しい構文を使えば実行中に構文誤りとして落ちます。npm は同じ状況を EBADENGINE の警告として知らせ、既定では設置を止めません。
直しかた
nvm install 20 && nvm use 20- 出す道具
- yarn 1
- ビルドと型
- 10
ビルドの誤りは実行前に道具が拒んだものなので、その場で何かを壊すわけではありません。代わりに二つを問います — 型や経路を実際の形に合わせて直すのか、それとも as any や抑制のコメント一つでその行だけ通すのか。そして大文字小文字や拡張子、環境変数のように自分の環境でだけ正しいものは、ここで初めて姿を見せます。
エラーメッセージの読み方
- 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
- ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
- 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
- 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
- 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。
よくある質問
Q. The engine "node" is incompatible with this module. Expected version ">=20" はどういう意味ですか。
入れようとしているパッケージが package.json の engines に必要な node の版を書いており、今使っている版がその範囲の外だという意味です。後ろに付く Expected と Got が要求範囲と自分の版を並べて見せるので、その二行だけ見れば足ります — CI でだけ出るなら、そこの node の版が自分の環境と違うということです。nvm install 20 && nvm use 20 で node を上げるのが正面の答えで、.nvmrc や CI の設定にも同じ版を書いておけば次にまたずれません。yarn の --ignore-engines で押し通せますが、それは警告を消すだけで互換性を作らないので、そのパッケージが新しい構文を使えば実行中に構文誤りとして落ちます。npm は同じ状況を EBADENGINE の警告として知らせ、既定では設置を止めません。
Q. どう直しますか。
nvm install 20 && nvm use 20 — 実行する前に、この命令が何を捨てるかを上の説明で確かめてください。
Q. どの道具が出すエラーですか。
yarn 1 です。ビルドと型の仲間で、文句は11語です。