Node.js 開発環境

Topics

ブロックエディター用の開発を行うには、Node.js 開発ツールとコードエディター、そしてローカルの WordPress 環境が必要です (ブロック開発環境 を参照してください)。Node.js (node) はオープンソースの実行環境で、ターミナル (コマンドラインインターフェース、CLI、またはシェルとも呼ばれる) から JavaScript コードを実行できます。

node をインストールすると、Node Package Manager (npm) と Node Package eXecute (npx) が自動的にインストールされます。

Node Package Manager (npm) は、依存関係の管理やスクリプトの実行など、複数の役割を果たします。推奨のパッケージマネージャであり、すべてのドキュメントで広く使用されています。

Node Package eXecute (npx) ツールは、パッケージからコマンドを、グローバルにインストールすることなく実行するために使用され、create-blockパッケージでブロックの雛形を作成する際によく使用されます。

Mac や Linux での nvm を使用した Node.js のインストール

Node.js のインストールには、Node Version Manager (nvm) の使用を推奨します。特定のバージョンの node をインストール、管理でき、ホームディレクトリにローカルにインストールされるため、グローバルなパーミッションの問題を回避できます。

以下は nvm を使用して node をインストールし、ブロック開発に推奨される Node.js のバージョンを設定する簡単な手順です。詳細については、完全なインストールガイド を参照してください。

  1. ターミナルを開き、次のコマンドを実行して nvm をインストールする。macOS にはデフォルトでは必要な開発ツールがインストールされていません。もしもプロンプトが表示されたら、そちらをインストールしてください。
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
  1. ターミナルを終了し、再起動する。
  2. ターミナルで nvm install --lts を実行し、最新の LTS (Long Term Support) バージョンの Node.js をインストールする。
  3. ターミナルで node -v と npm -v を実行して、インストールされた node と npm のバージョンを確認する。

必要であれば、特定のバージョンの node もインストールできます。例えば、nvm install 18 を実行してバージョン 18 をインストールし、nvm use [バージョン番号] を実行して異なるバージョンに切り替えられます。詳しくは nvm 利用ガイド を参照してください。

Gutenberg を含むいくつかのプロジェクトでは、.nvmrc ファイルを利用して、使用する node のバージョンを指定します。このとき nvm use を実行すると、自動的に正しいバージョンが選択されます。そのバージョンがまだインストールされていなければ、どのバージョンを追加する必要があるかを示すエラーが表示されます。nvm install [version-number] を実行したあとで、nvm use を実行してください。

Top ↑

Windows やその他の OS での Node.js のインストール

Node.js のメインの Web サイトから直接 Nodejs インストールプログラムをダウンロード できます。最新バージョンのインストールを推奨します。Windows と Mac ではインストールプログラムを、Linux ではバイナリーモジュールを利用できます。

Windows と WSL 上に nvm と Node.js をインストールする方法についての詳細なガイドが Microsoft から提供されています。

Top ↑

トラブルシューティング

もし node のインストールで、エラー zsh: command not found: nvm が発生したら、デフォルトのプロファイルファイルを作成する必要があるかもしれません。

macOS のデフォルトシェルは zsh です。プロファイルファイルを作成するにはターミナルで touch ~/.zshrc を実行してください。すでに同じファイルがあっても構いません。WSL を含む Ubuntu のデフォルトシェルは bash です。作成には touch ~/.bashrc を使用してください。その後で、手順2〜4を繰り返します。

最新の node バージョンであれば、ほとんどの開発プロジェクトで動作するはずです。しかしパッケージやツールによっては特定の要件があることに注意してください。問題が発生する場合は、以前のバージョンの node をインストールし、使用する必要があるかもしれません。また、プロジェクトに .nvmrc があるかどうかを確認し、指定された node バージョンを使用してください。

Top ↑

追加のリソース

原文

最終更新日: