npm runで出るMissing scriptエラーの直し方

​​npm​Node.js,トラブルシュート

ターミナルで npm run dev などを実行して npm error Missing script: "dev" と出たら、今いるプロジェクトの package.json の scripts に、その名前のスクリプトがありません。引数なしの npm run で実際にある名前を確かめ、その名前で実行し直すか、scripts にその名前を足せば、エラーは出なくなります。

開発サーバーの起動(npm run dev)やビルド(npm run build)、npm start を、READMEや手順書に書かれたとおりに打ったのに動かない、という場面で出るエラーです。私は検証環境でこのエラーを起こし、出たメッセージの全文と、直すと消えることを確かめました。

補足

検証環境は Ubuntu 24.04 です。主に Node.js 22.23.4(npm 10.9.9)で試し、比べるために npm 9.9.4 と、Node.js 24.22.1 に付いてくる npm 11.19.1 でも同じ操作をしました。Windows と macOS、yarn や pnpm、workspaces を使うプロジェクトは試していません。

エラーの全文

検証では、npm init -y で作った package.json に build を足し、scripts が2つだけのプロジェクトを用意しました。package.json のうち scripts の部分は次のとおりです。

json

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "echo build done"
  },

ここで、scripts にない dev を指定すると、npm 10.9.9 では次のように出て止まりました(終了コードは1。パスは例示用の値に置き換えています)。

text
$ npm run dev
npm error Missing script: "dev"
npm error
npm error To see a list of scripts, run:
npm error   npm run
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-12T03_39_21_543Z-debug-0.log

1行目が「dev というスクリプトがない」という意味で、その下に「スクリプトの一覧を見るには npm run を実行してください」と続きます。npm 11.19.1 でも同じ文面でした。

npm 9.9.4 では、行頭が npm ERR! になります。同じ操作の出力は次のとおりです(パスは例示用の値に置き換えています)。行頭のほかには、最後の行の前に空行が入ること、npm ERR! のあとに何もない行の末尾に空白が付くことが違うだけでした。

text
$ npx -y npm@9.9.4 run dev
npm ERR! Missing script: "dev"
npm ERR! 
npm ERR! To see a list of scripts, run:
npm ERR!   npm run

npm ERR! A complete log of this run can be found in: ~/.npm/_logs/2026-11-12T03_39_30_846Z-debug-0.log

まず npm run で、実際にある名前を確かめる

メッセージにあるとおり、npm run を名前なしで実行すると、使えるスクリプトの一覧が出ます。

text
$ npm run
Lifecycle scripts included in app@1.0.0:
  test
    echo "Error: no test specified" && exit 1
available via `npm run-script`:
  build
    echo build done

test は上の Lifecycle scripts の段に、build は下の段に、実行される中身と一緒に並びます。この一覧に dev がなければ、このプロジェクトには dev がありません。一覧の中身を見て、目的に合う名前を探します。

打ち間違いのとき、候補が出る場合と出ない場合

名前を打ち間違えたときも、同じ Missing script になります。大文字の Build と打つと、メッセージに候補が出ました(パスは例示用の値に置き換えています)。

text
$ npm run Build
npm error Missing script: "Build"
npm error
npm error Did you mean this?
npm error   npm run build # run the "build" package script
npm error
npm error To see a list of scripts, run:
npm error   npm run
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-12T03_39_21_909Z-debug-0.log

一方、文字の順番を入れ替えた biuld では、候補が出ずに、最初の dev のときと同じ形のメッセージになりました。npm 9.9.4 と npm 11.19.1 でも同じでした。

候補が出るかどうかは、npm 10.9.9 では、ソースの lib/utils/did-you-mean.js の処理で決まっています。打った名前と、npm のコマンドやスクリプト、package.json の bin の名前との違いの大きさ(何文字直せば同じになるか)が、打った名前の文字数の4割より小さいものだけを候補にします。Build は build と1文字違いで、5文字の4割の2より小さいので候補になります。biuld は build と2文字違いと数えられ、2より小さくないので候補になりません。候補が出ないからといって、似た名前のスクリプトがないとは限りません。

npm start は、server.js があればエラーにならない

start がないプロジェクトで npm start を実行すると、やはり Missing script: "start" になります。このときは、名前の近い npm のコマンドが候補に出ました(パスは例示用の値に置き換えています)。

text
$ npm start
npm error Missing script: "start"
npm error
npm error Did you mean one of these?
npm error   npm star # Mark your favorite packages
npm error   npm stars # View packages marked as favorites
npm error
npm error To see a list of scripts, run:
npm error   npm run
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-12T03_39_22_018Z-debug-0.log

npm star はパッケージをお気に入りに入れるコマンドで、start の代わりにはなりません。

npm start の説明には、scripts に start がなければ node server.js を実行する、と書かれています。プロジェクトの一番上に server.js を置いて試すと、start がないままでもエラーにならず、node server.js が実行されました。

text
$ npm start

> app@1.0.0 start
> node server.js

server.js started

フォルダーが違うときは、別のエラーになる

npm run は、今いるフォルダーに package.json がなければ、親のフォルダーをさかのぼって、package.json(または node_modules)のあるフォルダーを探します(npm がプロジェクトのフォルダーを決める方法の説明)。検証でも、プロジェクトの中の src フォルダーで npm run build を実行すると、一番上の package.json の build が動きました。

さかのぼっても package.json が見つからないフォルダーで実行すると、Missing script ではなく ENOENT のエラーになりました(終了コードは254。パスは例示用の値に置き換えています)。

text
$ npm run dev
npm error code ENOENT
npm error syscall open
npm error path /path/to/other/package.json
npm error errno -2
npm error enoent Could not read package.json: Error: ENOENT: no such file or directory, open '/path/to/other/package.json'
npm error enoent This is related to npm not being able to find a file.
npm error enoent
npm error A complete log of this run can be found in: ~/.npm/_logs/2026-11-12T03_39_22_491Z-debug-0.log

さかのぼって探すので、別のプロジェクトのフォルダーの中や、package.json を持つ親フォルダーの下で実行すると、その package.json の scripts が読まれます。Missing script が出て、npm run の一覧が思っていたものと違うときは、cd で目的のプロジェクトのフォルダーに移ってから実行し直してください。

scripts に足すと消える

そのプロジェクトに dev が本当に必要なら、package.json の scripts に足します。エディターで書き足してもかまいません。検証では npm pkg set で足しました。ここでは、動いたことが分かるように、中身は文字を表示するだけのコマンドにしています。

text
$ npm pkg set scripts.dev="echo dev server started"
$ npm pkg get scripts
{
  "test": "echo \"Error: no test specified\" && exit 1",
  "build": "echo build done",
  "dev": "echo dev server started"
}

同じコマンドを実行し直すと、エラーは出ずにスクリプトが実行されました(終了コードは0)。

text
$ npm run dev

> app@1.0.0 dev
> echo dev server started

dev server started

npm run の一覧にも、build の下に dev が加わりました。

スクリプトがなくてもエラーにしたくないとき

--if-present を付けると、スクリプトがないときにエラーで止まりません。dev がない状態で npm run dev --if-present を実行すると、何も表示されずに終了コード0で終わりました。npm の設定の説明にも、scripts にないスクリプトを実行しようとしたときに、エラーの終了コードで終わらないようにするもの、と書かれています。

注意

--if-present を付けると、名前を打ち間違えていてもエラーになりません(npm run biuld --if-present でも終了コード0でした)。Missing script を消す目的で付けると、スクリプトが実行されていないことに気づけません。

​Posted by 86