Node.jsって何?

Node.js公式サイト)は、フリーでオープンソースなJavaScript実行環境ツールです。

  • ブラウザなしでJavaScriptが動く
  • 開発ツール(npmなど)が使える
  • Web開発ではほぼ必須

よくある例

  • ローカルサーバーを立てる
  • パッケージ(ライブラリ)を入れる
  • ビルドや自動処理をする

👉 **「開発の裏方を全部やってくれる存在」**と思うと分かりやすいです。

また、Node.jsは、活発な開発とメンテナンスが行われており、Node.jsのリリースのように、複数のバージョンが存在します。

開発者の方、関係者の方には、この場をお借りして、深くお礼を申し上げたいと思います。

そして重要なのはここです👇

👉 Node.jsは、直接インストールするのではなく、Node.jsのバージョン管理ツールで管理するのが今の主流です。

理由はシンプルです:

プロジェクトごとにNode.jsのバージョンが違う 後から変更するとトラブルになりやすい Node.jsのバージョン管理ツールなら自動で切り替えてくれる

👉 結論:最初から「Node.jsのバージョン管理ツール+Node.js」で環境を作るのがベストです


Node.jsのバージョン管理ツール

Windowsにおいても、Node.jsの複数のバージョンを管理してプロジェクト毎にバージョンを切り替えて使用することができるツールには、下記のようなものがあります。

  • nodist
  • nvm-windows
  • Volta
  • n
  • fnm

私自身は、Windowsだけでなく、MacOSやLinuxなどでも使用でき、動作も安定しているVolta公式サイト)を利用しています。

バージョンの切り替えが高速で、プロジェクトごとにバージョンを固定できるのも利点です。

開発者の方、関係者の方には、この場をお借りして、深くお礼を申し上げたいと思います。

以降、当サイトでは、Node.jsのバージョン管理ツールにVoltaを使用します。


Node.jsの導入手順

手順①:ターミナルを開く

Windowsの場合:

スタートボタンを右クリック 「ターミナル」をクリック

👉 これからの作業はすべて起動された「ターミナル」のウインドウに入力します

手順②:Voltaをインストール

以下を入力:

winget install Volta.Volta

確認:

volta --version

👉 バージョンが出ればOK

手順③:Node.jsをインストール

例:安定版を入れる

volta install node

またはバージョン指定:

volta install node@24

確認:

node -v

👉 バージョンが表示されれば成功

手順④:プロジェクトごとにNode.jsを固定(超重要)

プロジェクトフォルダに移動:

例:test-project

cd test-project

固定:

volta pin node@24

👉 これで test-project は「Node.jsバージョン24固定」になります


手順⑤:各プロジェクトごとに node_modules を導入

各プロジェクトフォルダ毎に、Node.jsを初期化

npm init -y

👉 該当プロジェクトフォルダの直下に node_modules が作成されます。


よくある実践例

例①:プロジェクトごとにNode.jsのバージョンが違う

  • Aプロジェクト → Node 18
  • Bプロジェクト → Node 24

👉 Voltaならプロジェクト毎に固定化しておけば、自動で切り替え

例②:プロジェクトのNode.jsのバージョン変更

node_modulesの再インストールが必要です。

下記のコマンドでnode_modulesを削除後、再インストールを行います。

Remove-Item node_modules -Recurse -Force
Remove-Item package-lock.json -Force
npm install

もし、Electronを使用している場合は、Electron自身のキャッシュの削除も必要になります。上記に変えて、下記のコマンドでElectronのキャシュも一緒に削除した上でnode_modulesの再インストールをすることをおすすめします。

Remove-Item node_modules -Recurse -Force
Remove-Item package-lock.json -Force
Remove-Item dist -Recurse -Force
Remove-Item "$env:LOCALAPPDATA\electron" -Recurse -Force
Remove-Item "$env:LOCALAPPDATA\electron-builder" -Recurse -Force
npm install


まとめ

  • Node.jsはJavaScript開発の土台
  • 直接インストールは非推奨
  • Volta等のバージョン管理ツールで管理するのが現代のベストプラクティス

👉 最短ルートはこれ:

  1. Volta等のバージョン管理ツールを入れる
  2. Volta等のバージョン管理ツール経由で必要なバージョンのNode.jsを入れる
  3. 各プロジェクトごとにNode.jsのバージョンを固定する