Next.jsで学ぶReact講座 90日コース | ReactのためのJavaScript基礎 - Day 1:開発環境を準備する

React Next.jsで学ぶReact講座90日コース
スポンサーリンク
スポンサーリンク

Day 1:Reactを始めるための開発環境を準備する

この日のゴールは、パソコン上にJavaScriptの開発環境を用意し、小さなプロジェクトを作り、変更をGitで記録し、その記録をGitHubへ送ることです。最初から全部の仕組みを暗記する必要はありません。まずは手順を一度最後まで進め、各コマンドが何をしているかを少しずつ理解していきましょう。

この講座で使う言葉

  • Node.js:パソコン上でJavaScriptを動かすための実行環境です。
  • npm:JavaScriptのパッケージを管理する道具です。通常、Node.jsと一緒にインストールされます。
  • パッケージ:ほかの人が作って公開した、再利用できるプログラム部品やツールです。
  • Git:ファイルの変更履歴を記録する道具です。
  • GitHub:Gitで記録したプロジェクトをインターネット上に保存・共有できるサービスです。
  • VS Code:コードを書いたり、ファイルを見たりするためのエディターです。

1. Node.jsとは

ブラウザーの中では、JavaScriptを動かせます。Node.jsを使うと、ブラウザーの外でもJavaScriptを実行できるようになります。ReactやNext.jsの開発では、アプリを作るためのツールを動かしたり、開発中の画面を表示したりするときにNode.jsを利用します。

たとえるなら、JavaScriptが「料理のレシピ」で、Node.jsはそのレシピをブラウザー以外の場所でも調理するための「調理環境」のようなものです。

Reactで学習を進めると、Node.jsの上で動く開発ツールを使います。Node.jsが入っていないと、そうしたツールを起動できなかったり、パッケージのインストールができなかったりします。

2. npmとパッケージとは

npmは、プロジェクトに必要なパッケージをインストールしたり、プロジェクトの設定を管理したりするための道具です。Node.jsを公式サイトからインストールすると、一般的にはnpmも一緒に使えるようになります。公式サイトではNode.jsのLTS版が案内されています。(🔗 nodejs.org)

たとえばReactを使うプロジェクトでは、Reactや開発用ツールなどをパッケージとして利用します。自分で一からすべて作るのではなく、必要な機能をパッケージとして追加して開発します。

各プロジェクトの設定は、主にpackage.jsonというファイルに記録されます。このファイルには、プロジェクト名や利用するパッケージ、実行できるコマンドなどが書かれます。パッケージをインストールすると、package-lock.jsonというファイルも作られます。これはインストールされたパッケージの細かなバージョンを記録し、環境による差を少なくするためのファイルです。

3. VS Codeを準備する

VS Codeは、プログラムを書くためのエディターです。メモ帳でもコード自体は書けますが、VS Codeには、コードの色分け、エラーの発見を助ける表示、ターミナル、Gitの状態確認など、開発に便利な機能がまとまっています。

  1. VS Codeの公式サイトから、お使いのOSに合った版をインストールします。
  2. VS Codeを起動し、あとで作るプロジェクト用フォルダーを開きます。
  3. 画面内の「ターミナル」メニューから「新しいターミナル」を選びます。

VS Code内のターミナルを使うと、コードを書きながら同じウィンドウでコマンドを実行できます。ターミナルは後で繰り返し使うので、画面下部に表示できることを確認しておきましょう。

4. ターミナルの基本操作

ターミナルは、文字でコンピューターに指示を出す画面です。コマンドを入力し、Enterキーを押すと実行されます。最初は、現在の場所を調べる、フォルダーへ移動する、フォルダーを作る操作を覚えれば十分です。

操作macOS / LinuxWindows PowerShell意味
現在の場所を表示pwdpwdいま作業しているフォルダーを表示します
ファイル一覧を表示lslsその場所にあるファイルやフォルダーを表示します
フォルダーへ移動cd フォルダー名cd フォルダー名指定したフォルダーへ移動します
1つ上へ移動cd ..cd ..親フォルダーへ移動します
フォルダーを作成mkdir フォルダー名mkdir フォルダー名新しいフォルダーを作ります

コマンドは「どのフォルダーにいるか」によって、作られる場所や対象が変わります。実行前にpwdを使って現在地を確認する習慣をつけると、別のフォルダーで作業してしまう失敗を減らせます。

5. Node.jsとnpmをインストールして確認する

Node.jsは公式のダウンロードページから入手します。初心者は、通常の学習では「LTS」と表示された版を選ぶのが基本です。LTSは長期サポート版を指します。学習教材や使用する開発ツールが特定のNode.jsバージョンを指定している場合は、その指定を優先してください。(🔗 nodejs.org)

  1. Node.jsの公式ダウンロードページを開きます。
  2. 自分のOSに合ったLTS版を選んでインストールします。
  3. インストールが終わったら、ターミナルをいったん閉じてから開き直します。
  4. 次のコマンドを実行します。
# Node.jsのバージョンを表示します
node -v

# npmのバージョンを表示します
npm -v

数字を含むバージョンが表示されれば、コマンドを実行できています。たとえばv24.x.xのように表示されます。表示される番号はインストールした時期によって変わるため、例と完全に一致しなくても問題ありません。

よくあるつまずき

  • nodeやnpmが見つからないと表示される場合は、インストールが完了しているか確認し、ターミナルを再起動します。
  • インストールしたのに認識されない場合は、パソコンを再起動すると解決することがあります。
  • 古いNode.jsが表示される場合は、複数のNode.jsをインストールしている可能性があります。まずはどのバージョンが表示されるか記録し、教材や開発ツールが求めるバージョンと照らし合わせてください。
  • インストール用ファイルは、公式サイトなど信頼できる配布元から入手してください。

6. 練習用のnpmプロジェクトを作る

ここでは、react-day1という練習用フォルダーを作ります。次の例は、macOS・Linux・Windows PowerShellで使える基本的なコマンドです。

# 練習用フォルダーを作ります
mkdir react-day1

# 作ったフォルダーの中へ移動します
cd react-day1

# package.jsonを作成します
npm init -y

npm init -yは、npmプロジェクトの基本設定ファイルであるpackage.jsonを、質問に答えず初期設定で作るコマンドです。実行すると、package.jsonが作成されます。

フォルダーの内容を確認します。

# 現在のフォルダー内を表示します
ls

Windows PowerShellでもlsを使えます。ファイル一覧にpackage.jsonがあれば、プロジェクトを作成できています。

package.jsonの中身は、たとえば次のような形です。実際に作られる内容は環境やnpmのバージョンによって多少異なります。

{
  "name": "react-day1",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {},
  "keywords": [],
  "author": "",
  "license": "ISC"
}
JSON

nameはプロジェクト名、versionはプロジェクトのバージョンです。scriptsには、プロジェクト内で実行するコマンドを登録できます。Day 1では、内容をすべて理解しなくても大丈夫です。まずは「npmプロジェクトの設定がpackage.jsonに保存される」と押さえてください。

7. Gitとは

Gitは、ファイルの変更を記録していく仕組みです。たとえば、ファイルを編集したあとにGitへ記録を作ると、「どのファイルを、いつ、どのように変更したか」を後から確認できます。

GitHubは、Gitの記録をインターネット上に保存できるサービスです。パソコンの故障に備えたバックアップ、複数のパソコンでの作業、他の人との共同開発などに使われます。

覚えておきたい違いは次のとおりです。

  • Git:自分のパソコンで変更履歴を記録する仕組みです。
  • GitHub:Gitの履歴をインターネット上に置き、共有するサービスです。
  • commit(コミット):ローカルで変更履歴を記録する操作です。
  • push(プッシュ):ローカルのコミットをGitHubへ送る操作です。

8. Gitをインストールして初期設定する

Gitが使えるか、ターミナルで確認します。

# Gitのバージョンを表示します
git --version

バージョンが表示されれば、Gitのコマンドを使える状態です。Gitが見つからない場合は、OSに合ったGitをインストールしてください。インストール後は、ターミナルを再起動してからもう一度確認します。

Gitに記録を作るには、記録者の名前とメールアドレスを設定します。これはコミットに記録されます。GitHubに登録したメールアドレスを使う方法もありますが、メールアドレスを公開したくない場合は、GitHubのメール設定で案内される非公開用アドレスを使う方法もあります。

# Gitのコミットに記録する名前を設定します
git config --global user.name "Your Name"

# Gitのコミットに記録するメールアドレスを設定します
git config --global user.email "you@example.com"

# 設定した名前とメールアドレスを確認します
git config --global --list

Your Nameとyou@example.comは例です。自分の設定に置き換えてください。ここでの名前はGitHubのログインパスワードではありません。パスワードや認証トークンをコマンドに書いたり、ソースコードに保存したりしないでください。

9. プロジェクトをGitリポジトリにする

リポジトリとは、Gitで変更履歴を管理するプロジェクトの保管場所です。いまいる場所がreact-day1フォルダーであることを確認してから、Gitを初期化します。

# 現在の場所を確認します
pwd

# このフォルダーをGitリポジトリとして初期化します
git init -b main

# Gitが認識している変更状況を表示します
git status

git init -b mainは、このフォルダー内にGitの履歴管理を始め、最初のブランチ名をmainにします。ブランチは、変更を分けて作業するための仕組みです。Day 1では、まずmainという名前を使っておけば大丈夫です。

もし-bオプションが認識されない場合は、Gitのバージョンが古い可能性があります。その場合はGitを更新するか、次のように初期化後にブランチ名を変更できます。

# Gitリポジトリとして初期化します
git init

# 現在のブランチ名をmainにします
git branch -M main

10. .gitignoreを作る

Gitには、履歴に含めたくないファイルを指定する仕組みがあります。その指定を書くファイルが.gitignoreです。たとえば、インストールしたパッケージが保存されるnode_modulesフォルダーは、一般にGitHubへそのまま送る必要はありません。

VS Codeでreact-day1フォルダーを開き、新しいファイルを作成して、ファイル名を.gitignoreにします。ファイルの内容は次のとおりです。

# インストールされたパッケージはGitに含めません
node_modules/

# OSやエディターが作る一時ファイルをGitに含めません
.DS_Store
Thumbs.db

.gitignoreは、Gitにまだ追跡されていないファイルを無視するための設定です。すでにGitに追加されたファイルを、あとから.gitignoreに書くだけでは履歴から外れない点に注意してください。

Node.jsのプロジェクトでは、package-lock.jsonは通常Gitに記録します。インストール環境の差を減らすために役立つファイルなので、.gitignoreに追加しないでください。

11. GitHubにリポジトリを作る

GitHubにサインインし、新しいリポジトリを作成します。リポジトリ名には、たとえばreact-day1を使えます。初めて手順を試す場合は、公開・非公開の意味を理解したうえで選びましょう。

  • Public(公開):インターネット上の他の人も見ることができます。
  • Private(非公開):許可した人以外は見ることができません。

学習用であっても、個人情報や秘密情報を含む可能性があるなら、まずPrivateにするのが安全です。作成画面でREADME、.gitignore、ライセンスを自動追加する設定を選ばず、空のリポジトリとして作成すると、これからローカルで作る履歴とぶつかりにくくなります。

GitHubのドキュメントでは、ローカルにあるリポジトリを追加する場合、認証を済ませたうえでリモートを設定し、git push -u origin mainで送る流れが案内されています。(🔗 docs.github.com)

12. ファイルをGitに記録する

GitHubへ送る前に、まずローカルで変更を記録します。react-day1フォルダーにいることを確認して、次のコマンドを実行してください。

# 現在のフォルダーと変更状況を確認します
git status

# Gitに記録するファイルを選びます
git add .

# 選んだファイルを履歴として記録します
git commit -m "Create day 1 project"

それぞれの意味は次のとおりです。

  • git statusは、変更されたファイルや未記録のファイルを表示します。
  • git add .は、現在のフォルダーにある変更を次の記録対象にします。
  • git commit -m "..."は、変更に短い説明をつけて履歴に記録します。

git add .は、現在のフォルダー以下のファイルをまとめて記録対象にする便利なコマンドです。一方で、秘密情報や不要な大きなファイルも対象にしてしまう可能性があります。コミットする前に必ずgit statusで一覧を確認してください。

GitHubは、パスワード、APIキー、SSH秘密鍵、クレジットカード番号などをリポジトリに追加しないよう注意喚起しています。.envファイルなどに秘密情報を保存する場合は、そのファイルを.gitignoreに追加し、Gitに含めないようにしてください。(🔗 docs.github.com)

13. GitHubにpushする

GitHubで作った空のリポジトリを、ローカルのGitに接続します。GitHubのリポジトリ画面に表示されているHTTPS形式のURLをコピーし、下のhttps://github.com/ユーザー 名/react-day1.gitの部分と置き換えてください。

# GitHubのリポジトリをoriginという名前で登録します
git remote add origin https://github.com/ユーザー 名/react-day1.git

# ローカルのmainブランチをGitHubへ送ります
git push -u origin main

originは、GitHub上のリポジトリを指すためによく使われる名前です。-uを付けてpushすると、次回以降はgit pushだけで同じ場所へ送れるようになります。

初回pushでは、GitHubへのサインインや認証が求められることがあります。GitHubのパスワードをGitの入力欄にそのまま使えるとは限りません。画面に表示される案内に従って、ブラウザー認証やGitHub CLIなど、公式の認証方法を使ってください。GitHub CLIではgh auth loginで認証し、対話形式でローカルリポジトリをGitHubに追加してpushする方法も案内されています。(🔗 docs.github.com)

14. pushできたか確認する

pushが成功したら、GitHubのリポジトリページをブラウザーで開きます。package.json、.gitignoreなどのファイルが表示されていれば、ローカルからGitHubへ送れています。

ターミナルでも状態を確認できます。

# GitHubとの接続先を表示します
git remote -v

# Gitの現在の状態を確認します
git status

git statusにworking tree cleanと表示される場合、記録していない変更が残っていない状態です。表示文はGitのバージョンや設定により少し異なることがあります。

15. つまずいたときの確認ポイント

表示や状況確認すること
nodeまたはnpmが見つからないNode.jsをインストールしたか、ターミナルを再起動したか確認します
gitが見つからないGitをインストールし、ターミナルを開き直して確認します
nothing to commitと表示されるすでに変更が記録されているか、Gitが追跡するファイルに変更がないか確認します
GitHubへの接続で認証に失敗するGitHubのブラウザー認証など、案内された公式の認証を完了します
remote origin already existsと表示されるすでに接続先が登録されています。git remote -vでURLを確認します
pushで履歴が合わないというエラーになるGitHub側でREADMEなどを先に作成していないか確認します。初心者は空のリポジトリから始めると混乱を減らせます

remote origin already existsが出た場合は、すぐに設定を削除せず、まず接続先を見ます。

# 登録済みのリモートURLを表示します
git remote -v

表示されたURLが目的のGitHubリポジトリと違うと確認できた場合に限り、接続先を更新できます。

# originの接続先を正しいGitHub URLに変更します
git remote set-url origin https://github.com/ユーザー 名/react-day1.git

16. Day 1の実践チェックリスト

  • Node.jsをインストールし、`node -v`でバージョンを確認できました。
  • `npm -v`でnpmのバージョンを確認できました。
  • VS Codeでプロジェクトフォルダーを開き、ターミナルを表示できました。
  • `npm init -y`で`package.json`を作成できました。
  • Gitをインストールし、名前とメールアドレスを設定できました。
  • `git init`でローカルのリポジトリを作成できました。
  • `git add`と`git commit`で変更を記録できました。
  • GitHubに空のリポジトリを作り、ローカルの内容をpushできました。
  • 公開範囲を確認し、パスワードやAPIキーなどの秘密情報を含めていないことを確認できました。

ここまでできれば、Day 1のゴールである「開発環境を自力で準備する」の土台はできています。特に大切なのは、エラーの文章を落ち着いて読み、作業中のフォルダー、コマンドの実行結果、Gitの状態を一つずつ確認することです。次の学習では、このプロジェクトにJavaScriptのファイルやReactの開発環境を追加していきます。

タイトルとURLをコピーしました