メインコンテンツまでスキップ

Git と GitHub

Git リポジトリを作成する​

Git では、リポジトリと呼ばれる単位でソースコードを管理します。リポジトリはひとつのディレクトリに相当し、そのディレクトリ以下の全てのファイルが Git による追跡対象となります。

まずは Git で管理するためのディレクトリを作成し、VS Code で開きます。左側のアクティビティバーの Source Control パネル内の Initialize Repository ボタンを押してください。これで、カレントディレクトリを Git の管理下に置く (カレントディレクトリを Git リポジトリにする) ことができます。

git init コマンド

Git の操作は、コマンドからも行うことが出来ます。カレントディレクトリを Git の管理下に置くには、次のコマンドを実行してください。

git init
.git ディレクトリ

Git の管理下に置かれたディレクトリには .git という名前のディレクトリが生成されます。このディレクトリには過去のコミットの履歴など、Git が内部的に使用するファイルが格納されます。誤ったディレクトリで git init コマンドを実行してしまった場合、このディレクトリを削除しましょう。なお、ピリオドから始まるディレクトリやファイルは ls コマンドに -a というオプションをつけないといけないので注意が必要です。

$ ls
$ ls -a
.  ..  .git
$ ls .git
branches  config  description  HEAD  hooks  info  objects  refs

最初のコミットを作成する​

コミットは、リポジトリのある時点での状態です。ここでいう状態とは、リポジトリ内のすべてのディレクトリやファイルの名前、その内容、変更日時などです。Git では、コミットを作成することにより、リポジトリへの変更内容を記録します。

それでは、前項で作成したリポジトリで最初のコミットを作成してみましょう。まずはファイルを作成し、適当な内容で保存します。

コミットを作成する前に、変更をステージする必要があります。ステージとはコミットの直前の状態で、Git に対して該当ファイルをコミットする意思があることを伝えるためのものです。Source Control パネル内の変更したファイルの横の + ボタンを押します。ファイルが Changes から Staged Changes に移ったら成功です。

git status コマンド

現在の状況を確認するには、git status コマンドを使います。

ステージされていない場合は、次のように表示されます。

ステージされる前の状態

ステージされた後では、次のように表示されます。

ステージされた後の状態

git add コマンド

コマンドラインから変更をステージする場合には、git add コマンドを実行します。

$ git add ステージするファイルへのパス
$ git add -A # リポジトリ内部のすべてのファイルをステージする場合

git add コマンドを使う前後で git status コマンドの結果が変化していることを確認しましょう。

ステージされた変更からコミットを作成するには、コミットメッセージを入力して Commit ボタンを押します。コミットメッセージには、そのコミットで行われた変更を説明する簡潔なメッセージを入力してください。(日本語も使うことが出来ます。)

変更がコミットとして記録されました。

git commit コマンド

コマンドラインで実行するには、git commit コマンドを使用します。

git commit -m "コミットメッセージ"

ある程度変更がまとまったら、ステージ、コミットを繰り返してプログラムを書き進めていきましょう。

.gitignore

.gitignore ファイルで指定されたファイルは Git の管理下に置かれません。npm install で簡単にダウンロードできて容量が大きいのでバージョン管理するメリットのない node_modules や、機密情報や環境ごとに異なる情報を含む .env といったファイルが指定されます。

変更履歴を表示する​

先ほど作成したファイルを変更し、ステージした後、もう一度コミットを作ってみましょう。

これにより、2 つ目のコミットが作成されました。コミットの履歴を確認するために、先ほどインストールした Git Graph 拡張機能を起動してみましょう。command / Ctrl + Shift + P キーを押してコマンドパレットを開き、Git Graph: View Git Graph (git log) を選択します。

git log コマンド

コマンドを用いて変更を表示するには、git log コマンドを使用します。

git diff コマンド

コミットには一意の ID が割り当てられており、この ID を git diff コマンドに与えることで、コミット同士を比較することができます。

下の動画の最後で実行されている git diff @ @~ は、最新のコミットとそのひとつ前のコミットを比較するためのコマンドです。@ が最新のコミットを、~ が「そのひとつ前」を表します。

変更を GitHub に保存する​

自分のコンピューター上に作成したリポジトリと同期させるため、GitHub 上にもリポジトリを作成します。GitHub 上部のメニューから New repository を選択してください。

リポジトリ

必要な設定はリポジトリの名前と公開範囲です。公開するつもりがない場合は公開範囲は Private に設定するようにしましょう。

リポジトリの設定

続いて、作成したリポジトリと自分の PC 上にあるリポジトリを紐づけます。GitHub 上に表示されている SSH の URL をコピーします。(SSH にするのを忘れないでください。) これが GitHub 上に作成したリポジトリを表す URL (リモートリポジトリの URL) になります。次のコマンドを実行して、このリモートリポジトリを origin (慣習的にリモートリポジトリが一つだけの場合はこの名前が用いられます) という名前で登録します。

git remote add origin git@github.com:アカウント名/リポジトリ名.git

追加が完了したら、origin として登録したリモートリポジトリにコミットを送信します。この操作をプッシュと呼びます。プッシュをするには、Publish Branch を押します。

備考

この操作の際、初回は以下のような警告が出る場合があります。

"github.com" has fingerprint "SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdk4UvCOqU."
Are you sure you want to continue connecting?

これは、接続先となっている GitHub が、なりすましではなく本物の GitHub であると信頼してもよいかを尋ねるメッセージです。家庭用のインターネット回線、UTokyo Wi-Fi 等、十分に信頼できるネットワークに接続している場合は問題ありませんので、 yes と入力して続行させてください。

HTTPS と SSH

GitHub 上のリポジトリの URL には HTTPS と SSH の2種類があります。

HTTPS の URL は https://github.com/アカウント名/リポジトリ名.git のような形で、この URL では SSH 鍵を登録しなくても誰でもパブリックリポジトリのプルができますが、プッシュはできません。 また、プライベートリポジトリはプルすることもできません。

SSH の URL は git@github.com/アカウント名/リポジトリ名.git のような形で、この URL を使うには GitHub アカウントを作成し SSH 鍵を登録する必要がありますが、自分のリポジトリであればパブリックでもプライベートでもプルとプッシュができます。 他の人のリポジトリの場合は HTTPS と同様にプルのみができます。

SSH 鍵の登録を済ませているみなさんは基本的に SSH を使いましょう。 もし自分の PC 上に紐付ける URL を間違えてHTTPSにしてしまった場合は、

git remote set-url origin git@github.com:アカウント名/リポジトリ名.git

で再設定ができます。

git push コマンド

コマンドラインから実行するには、git push コマンドを使います。

git push origin main

このコマンドの main はブランチと呼ばれるソースコードの変更の分岐を表す名前で、何も指定しなければ main という名前になります。

GitHub を開いているブラウザを更新して、プログラムが反映されていることを確認したら完了です。