Reactの環境構築に必須!Node.jsとnpmのインストール方法(Windows/Mac/Linux対応)
生徒
「Reactを使うにはNode.jsとnpmが必要って聞いたんですけど、それって何ですか?」
先生
「Node.jsはJavaScriptをパソコン上で動かすための土台で、npmはそのお手伝いをする道具ですね。」
生徒
「うーん、難しそう…。インストールできるか不安です。」
先生
「大丈夫!これからパソコンの種類ごとに、丁寧にReactの準備を説明していきますよ!」
1. Node.js(ノード)とnpm(エヌピーエム)って何?
Node.js(ノードジェーエス)とは、Webブラウザの外でもJavaScriptを動かせるようにするソフトウェアです。
通常、JavaScriptはブラウザの中でしか動きませんが、Node.jsを使うことで「自分のパソコン上」でReactなどの開発ができるようになります。
npm(Node Package Manager)は、そのNode.jsに付属している「便利な道具箱」のようなものです。
Reactを使うための部品(パッケージ)を、自動でダウンロード・更新・管理することができます。
2. インストール前の確認:自分のOSを知ろう
Node.jsのインストール方法は、パソコンの種類(OS)によって異なります。
- Windows:マイクロソフト製のパソコン
- Mac:Apple製のパソコン(MacBookなど)
- Linux:UbuntuやDebianなど技術者向けのOS
それぞれの手順に合わせて進めましょう。
3. WindowsでのNode.jsとnpmのインストール手順
- Node.js公式サイトにアクセス
- 「LTS」と書かれた緑のボタンをクリック(安定版)
- インストーラー(
.msiファイル)がダウンロードされる - ダブルクリックしてインストールを開始
- 表示される画面で「Next(次へ)」を押していくだけで完了
インストール後、「スタートメニュー」から「コマンドプロンプト」を開いて、次のコマンドを入力しましょう:
node -v
npm -v
バージョン番号が表示されれば、正しくインストールできています。
4. MacでのNode.jsとnpmのインストール手順
Macの場合も、公式サイトからインストーラーを使えば簡単です。
- Node.js公式サイトにアクセス
- 「LTS」のダウンロードボタンをクリック
.pkgファイルがダウンロードされるので、開いてインストール- 画面の指示に従って「続ける」を押せば完了
インストール後、「ターミナル」アプリを開いて以下のコマンドで確認します:
node -v
npm -v
どちらも数字が出てくれば、正常にインストールされています。
5. LinuxでのNode.jsとnpmのインストール手順
Linuxは種類が多いですが、代表的なUbuntuを例に説明します。
- ターミナルを開く
- 以下のコマンドを順番に実行
sudo apt update
sudo apt install nodejs
sudo apt install npm
終わったら、バージョン確認をします:
node -v
npm -v
もし古いバージョンが入る場合は、nvm(Node Version Manager)というツールを使うと、最新版を簡単に管理できます。
6. Node.jsとnpmが正しく動いているか確認する
インストールが終わったら、次のように入力して確認しましょう。
node -v
npm -v
「v18.18.0」や「9.8.1」のようにバージョン番号が出てきたら成功です。
Reactでは、Node.jsが土台となってnpmがライブラリの出し入れを助けてくれます。この2つがあることで、Reactの環境構築がスムーズに進むのです。
7. よくあるトラブルと解決方法
- nodeコマンドが使えない: パソコンを再起動すると解決することがあります
- 古いバージョンがインストールされる:公式サイトからLTS版を再インストール
- npmコマンドが見つからない:Node.jsと一緒に入っているか確認
それでもうまくいかない場合は、エラーメッセージをGoogleで検索すると、多くの解決事例が見つかります。
まとめ
Reactの環境構築に欠かせないNode.jsとnpmの役割や、Windows・Mac・Linuxそれぞれでのインストール手順を振り返ってみると、最初は難しそうに感じる部分も、実際には順番に進めることで誰でも確実に準備できる内容であることが分かります。とくにNode.jsはJavaScriptをパソコン上で実行するための大切な土台であり、npmはReactをはじめとする数多くのライブラリを管理するための重要な仕組みです。これらを理解し確実に準備することが、Reactの開発を始めるうえでの最初の大きなステップとなります。 また、Reactの環境構築は一度きちんと整えてしまえば、その後のアプリ開発が非常にスムーズになります。コマンドでのバージョン確認や、OS別のインストール手順を把握しておけば、今後のバージョンアップや開発ツールのセットアップにも応用できるようになります。さらに、Node.jsとnpmが正しく動作することで、Reactのプロジェクト作成、ライブラリの導入、依存関係の管理など、現代的な開発ワークフローの中心となる作業がスムーズに行えるようになります。 そこで下記では、今回の内容を踏まえて、Node.jsとnpmの動作確認をするための簡単なサンプルプログラムを用意しています。React環境に進む前に、小さなJavaScript実行テストを行うことで、Node.jsがパソコン上でしっかり働いていることを確認できます。
Node.js動作確認用サンプルコード
console.log("Node.jsが正しく動作しています!");
console.log("npmを使えばReactや必要なパッケージも管理できます。");
上記のコードを test.js として保存し、ターミナルやコマンドプロンプトで node test.js を実行すると、Node.jsが問題なく動作していればメッセージが表示されます。これで環境構築の第一歩をクリアでき、Reactアプリを作るための土台が整ったことを確認できます。ここから先は、ViteやCreate React Appなどのツールを使ってReactプロジェクトを作成し、実際のコンポーネント開発へ進むことができます。
Node.jsとnpmの基礎をしっかり理解しておくと、Reactだけでなく、他のJavaScriptフレームワークやバックエンド開発にも応用できるようになり、プログラミングの幅が大きく広がります。今回の内容を丁寧に復習しながら、「なぜNode.jsとnpmが必要なのか」「なぜ環境構築が大事なのか」を理解しておくと、今後の学習効率も高まります。
生徒:「Node.jsとnpmって名前は聞いたことがありましたが、Reactのために必要な理由がよく分かりました!」
先生:「そうだね。Node.jsはJavaScriptをパソコン上で動かすためのものだし、npmはReactの部品を管理するための道具なんだよ。」
生徒:「WindowsやMac、Linuxでも手順が違うけど、丁寧にやればちゃんとインストールできますね。」
先生:「その通り。OSごとに画面は違うけど、基本の流れはとてもシンプルなんだよ。」
生徒:「Node.jsが動作しているかを確認するためのサンプルコードも役に立ちました。Reactを始める前にチェックできるのがいいですね。」
先生:「確かに。環境が整っているかどうかを確認しておくことで、Reactのプロジェクト作成もスムーズに進められるよ。」
生徒:「これでReactの勉強を始める準備ができました!次は実際にReactの画面を作ってみたいです!」
先生:「いいね。その気持ちを大切にして、一歩ずつ進んでいこう。Reactの世界はとても広いから、楽しみながら進めていけるよ。」