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等のバージョン管理ツールで管理するのが現代のベストプラクティス
👉 最短ルートはこれ:
- Volta等のバージョン管理ツールを入れる
- Volta等のバージョン管理ツール経由で必要なバージョンのNode.jsを入れる
- 各プロジェクトごとにNode.jsのバージョンを固定する