バージョン管理を始めよう
動いていたコードに手を加えたら突然壊れてしまった——そんな経験はありませんか？何を変えたか思い出せず、「動いていたときに戻れたらいいのに…」と思うはずです。バージョン管理はまさにビデオゲームのセーブポイント。コミットを作るたびに復元ポイントができ、必要なときにいつでも戻れます。GitHub を使えば、そのセーブポイントをクラウドに保存して安全にバックアップでき、どのコンピューターからでもアクセスできます。
主要な概念
- Git：ローカルPC上のファイル変更履歴を追跡するソフト
- GitHub：その履歴をクラウドに保存するサービス（コード版Google Drive）
- GitHub Desktop：GitをGUIで操作できる公式クライアント
- リポジトリ（repo）：変更履歴を記録するプロジェクトフォルダ
必要なもの
- WindowsまたはMacのパソコン（GitHub DesktopはLinuxでは動作しません）
- インターネット接続
- GitHubアカウント用のメールアドレス
- 15〜20分
ステップ1：GitHubアカウントを作成
- ブラウザで github.com へ
- Sign up をクリック
- メールアドレス・パスワード・ユーザー名を入力
- 案内に従って本人確認を完了
ステップ2：GitHub Desktopをインストール
- desktop.github.com を開き、Download をクリック
- ダウンロードしたファイルを開いてインストール
- Windows：インストーラーをダブルクリックすると自動でセットアップ＆起動
- Mac：ダウンロードした
.zipファイルを開き、GitHub Desktopをアプリケーション（Applications）フォルダへドラッグし、アプリケーションフォルダから起動
ステップ3：GitHub Desktopにサインイン
- アプリを開き Sign in to GitHub.com をクリックします
- ブラウザが自動で開くので、求められたらサインインし、Authorize desktop をクリックします
- ブラウザが GitHub Desktop を開くか尋ねてきたら、開く（または 許可）をクリックします
- アプリに戻り Finish をクリックしてセットアップを完了します
ステップ4：最初のリポジトリを作る
- GitHub Desktop のトップ画面で Create a New Repository on your Local Drive をクリックします
- 次のように入力：
- Name:
my-first-project（好きな名前でもOK） - Description:
Learning version control（任意） - Local Path: 保存先（書類／ドキュメント（Documents）フォルダなど）
- Initialize this repository with a README にチェック
- Name:
- Create Repository をクリック
ステップ5：フォルダを開いてみる
- メニューバーの Repository から Show in Finder（Mac）または Show in Explorer（Windows）を選択
my-first-projectフォルダとREADME.mdファイルが確認できます
ステップ6：READMEを編集
README.mdをメモ帳（Notepad）／テキストエディット（TextEdit）／VS Codeなどで開く- 内容を以下に書き換え、保存
# 初めてのプロジェクト GitHub Desktopでバージョン管理を学習中です。 ## 作成するもの このプロジェクトで学ぶこと： - コードの変更を追跡する - セーブポイント（コミット）を作成する - 作業をGitHubにバックアップする
ステップ7：初めてのコミット
- GitHub Desktopに戻ると差分が表示される（緑＝追加、赤＝削除）
- 左下のメッセージ欄に
プロジェクトの説明を追加と入力 - 青い Commit 1 file to main ボタンをクリック（数字は変更したファイルの数と一致します）
ステップ8：GitHubにプッシュ
- 画面上部の Publish repository をクリック
- 名前はそのままにし、他の人にもコードを見せたい場合のみ「Keep this code private」のチェックを外す（任意）
- Publish Repository を押して完了
これで https://github.com/YOUR-USERNAME/my-first-project にコードがバックアップされました。
次のステップ
- READMEをもう一度編集 → コミット → プッシュ
- 新しいファイルを作ってコミット
- GitHub Desktopの History タブで履歴を確認
トラブルシューティング
| 症状 | 対処 |
|---|---|
| GitHubにサインインできない | ネット接続を確認。まずブラウザでgithub.comにログインできるかチェック |
| 変更が表示されない | ファイルを保存したか確認。別のアプリをクリックしてからGitHub Desktopに戻るか、アプリを再起動する |
| Pushが「rejected」エラーで失敗する | 他の人が先にPushした可能性。Fetch origin → Pull origin → もう一度 Push origin をクリック |
基本ワークフロー
- ファイルを編集・保存
- GitHub Desktopで差分を確認
- 説明的なメッセージを付けて、下部の青いコミットボタン（Commit 1 file to main のように表示）をクリック
- Push origin でGitHubにバックアップ
- 繰り返す
Steven Ge 作成（2025年12月7日）