【超初心者向け】Python学習者がWindowsでGitとGitHubに挑戦！図解と例えで分かる使い方＆試行錯誤ログ

前回、Flaskで作成したWebアプリを無料でデプロイする方法について調べていた際に、「Git（ギット）」と「GitHub（ギットハブ）」を使う必要があるサービスが有りました。

そもそもGitって何？というところから始まりましたが、調べてみると、Gitは「バージョン管理システム」と呼ばれるものの一つだそうです。そこで今回は、プログラミング学習を進める上で避けては通れない（らしい）「Git（ギット）」と「GitHub（ギットハブ）」に挑戦してみました！

はじめに：なぜGitとGitHubを学ぼうと思ったか

Gitは「バージョン管理システム」と呼ばれるものの一つですが、「これを使うと何が便利なのか」というのが気になりますよね。

特にプログラミングでは、コードを少し変更したら動かなくなった、なんて日常茶飯事…。そんな時、Gitがあれば安心して変更前の状態に戻せます。また、複数人で同じプロジェクトを開発する際にも、誰がどのコードを書いたのか管理しやすくなるため、必須のツールとされています。

私の開発環境はWindowsです。今回は、Windows用のGit（Git for Windows）をインストールするところから、試行錯誤しながら学んだリアルな過程を、初心者目線で詳しく共有します。専門用語も、できるだけ分かりやすいたとえ話を交えながら解説していきますので、一緒に学んでいきましょう！

まずはGitをWindowsにインストール！

Gitを使うには、まず自分のPCにGitをインストールする必要があります。Windowsの場合は「Git for Windows」というものが公式から提供されています。これをインストールしましょう。

まずは、Git for Windowsの公式サイト にアクセスして、インストーラーをダウンロードします。

次に、ダウンロードしたインストーラーを実行します。基本的に、初期設定のまま「Next」を押していけばいいですが、気になった点や変更したほうが良い箇所があったため、その部分だけ解説します。

Select Componentsの設定

「Next」で進んでいくと、コンポーネントの設定で複数の選択肢が出てきました。選択肢について調べてみたところ、基本的にはデフォルトの設定で問題ありませんでした。特にこだわりがなければ、このまま「Next」で進めましょう。選択肢について解説しておきますので、必要に応じてチェックをつけてください。

Choosing the default editor used by Gitの設定

最初に選択されているのは「Use Vim (the ubiquitous text editor) as Git’s default editor」です。これは、コミットメッセージの編集など、Gitがテキストエディタを必要とするときに「Vim」というエディタを起動するという設定です。

Vimは操作方法が独特で、特に初心者の方には「文字を入力できない」「保存して終了する方法がわからない」といった状況に陥りやすいエディタです。（画面の説明にも “while powerful, can be hard to use.” と書かれていますね）

実際、私もVimを少し触ったことがあるのですが、操作がかなり独特で慣れる前に挫折してしまいました…

特にこだわりがなければ、Windows標準の「メモ帳」を選択する「Use Notepad as Git’s default editor」を選んでおくのが無難だと思います！

Adjusting the name of the initial branch in new repositoriesの設定

これは、新しくGitリポジトリを作成（git initした時）の最初のブランチ名をどうするかを決める設定です。デフォルトでは、「Let Git decide」が選択されていますが、これを選ぶと、Gitの現在のデフォルトである「master」という名前が最初のブランチ名になります。

基本的にはこれで問題ないのですが、最近の動向として、GitHubなどの主要なプラットフォームでは、新しいリポジトリのデフォルトブランチ名が「main」になっています。

そのため、「Override the default branch name for new repositories」を選択したうえで、入力欄に「main」と入力されていることを確認して「Next」を選択しましょう。

インストールの確認

最後まで進めてインストールが完了したら、無事にインストール出来ているか確認してみましょう。

コマンドプロンプトやPowerShell、またはGit for Windowsと一緒にインストールされる「Git Bash」を開いて、以下のコマンドを入力します。

git --version

このコマンドでgitのバージョン番号が表示されれば、インストール成功です！

ローカルでGitを使ってみる

インストールができたので、いよいよGitを使ってみます。まずは自分のPC（ローカル環境）だけで、Gitの基本的な操作を体験しましょう。

Gitの基本的な流れ（たとえ話つき）

Gitでの作業は、大きく以下の3ステップで行うことが多いです。

図解すると以下のようになります。

Gitを実際に操作してみよう！

操作の流れを理解したところで、実際に手を動かしながら確認してみましょう！

プロジェクト用フォルダの準備

まず、Gitで管理したいプロジェクト用のフォルダを用意します。今回は、作業したい場所で「my_python_project」というフォルダを作り、そこに簡単なPythonスクリプト hello.py を作成してみます。

print("Hello, Git World!")

リポジトリの作成 (git init)

コマンドプロンプトやGit Bashなどを開き、cd 作業フォルダのパスで先ほど作成したフォルダに移動します。そして、以下のコマンドを実行してリポジトリを作成します。

cd 作業フォルダのパス  # 作業フォルダへ移動
git init

コマンドを実行すると以下のようなメッセージが表示され、フォルダ内に .git という隠しフォルダが作成されます。この .git フォルダに、Gitが管理するための情報（変更履歴など）が全て格納されます。絶対にこのフォルダを直接編集したり削除したりしないでください！ （Windowsのエクスプローラーで「隠しファイル」を表示する設定にしないと見えません）

Initialized empty Git repository in 作業フォルダのパス/.git/

変更をステージング (git add)

hello.py を作成（または変更）し、その変更をステージングエリアに追加します。

# 特定のファイルを追加する場合
git add hello.py
# または、フォルダ内の全ての変更を追加する場合 (よく使います)
git add .

変更をコミット (git commit)

ステージングエリアに追加した変更内容を、メッセージ付きで記録します。

git commit -m "最初のコミット: hello.py を作成"

試した結果
私が初めてコミットを実施した際には以下のエラーが発生しました。これは、「コミットする人の情報（名前とメールアドレス）が設定されていないため、誰が変更したのか記録できません」というエラーです。

Gitでは、誰がどのような変更を行ったかを記録するために、コミット時に作者の情報（ユーザー名とメールアドレス）を記録します。そのため、最初のコミットを行う前に、以下のコマンドを実行してユーザー名とメールアドレスを設定する必要がありました。

git config --global user.email "あなたのメールアドレス"
git config --global user.name "あなたのユーザー名"

この設定を行った後にもう一度コミットを行うと、以下のように無事にコミット出来ました！これで、最初のセーブポイントを作成出来ましたね！

状態と履歴を確認する (git status, git log)

これまでの内容がちゃんと記録されたか、確認してみましょう。状態や履歴の確認には、以下2つのコマンドを使用します。

# 現在のリポジトリの状態を確認
git status 
# これまでのコミット履歴を確認 
git log

試した結果
git statusとgit logを実行すると、以下のように出力されました。それぞれのコメントの意味を調べた結果をまとめておきます。

まとめ

ここまで学んだ内容をまとめると、以下のようになりますね。

GitHubと連携：オンラインにバックアップ＆共有

ローカルPCでGitを使うだけでも十分便利ですが、「GitHub（ギットハブ）」というWebサービスと連携させると、さらに活用の幅が広がります。

GitHubとの連携

では、実際にGitとGitHubを連携していきましょう。以下の手順で進めます。

GitHubアカウント作成

GitHub公式サイト でアカウントを作成します（無料プランで十分です）。

リモートリポジトリ作成

GitHubにログインし、新しいリポジトリを作成します。リポジトリ名（例: my-python-project）を決め、Public（公開）かPrivate（非公開）かを選びます。最初は README.md などのファイルは追加せずに、「Create repository」ボタンを押すのがおすすめです。

ローカルリポジトリにリモートリポジトリを登録 (git remote add)

GitHubでリポジトリを作成すると、そのリポジトリのURL（HTTPSかSSH）が表示されます。このURLを、ローカルリポジトリに「リモートリポジトリの場所はここだよ」と教える必要があります。

# 例: HTTPSの場合
git remote add origin https://github.com/[あなたのユーザー名]/[リポジトリ名].git

origin というのは、登録するリモートリポジトリに付けるニックネームです。慣習的に origin という名前がよく使われますが、別名でも構いません。

ローカルのコミットをリモートに送信 (git push)

ローカルで行ったコミット（セーブポイント）を、GitHub上のリモートリポジトリにアップロードします。

git push -u origin main

試した結果
初回の連携時には、以下のような画面が表示されました。これは、gitとgithubを連携する際に「Git Credential Manager (GCM)」というツールを使って連携する設定画面のようです。次回からは表示されないので、サインインして連携しておきましょう。

Github上で確認すると、以下のようにちゃんとオンラインへアップロード出来ていました。

まとめ

以上の手順で、GitとGitHubを連携することが出来ました。ここまでの内容を改めてまとめて図解すると、以下のような形ですね！しっかりとこの構造を意識しながら使っていきましょう！

【発展】ブランチを切ってみる – 安全に新しい機能を試す魔法

Gitの強力な機能の一つに「ブランチ（Branch）」があります。そこで、次はブランチを使ってみようと思います。

Gitのブランチ（Branch）とは？：例えを踏まえて

ブランチを使うメリット
メリットとして、主に以下の２点が挙げられます。

では、実際にブランチを使ってみましょう！

ブランチの使い方

ブランチ作成と移動 (git checkout -b または git switch -c)

新しいブランチを作成し、すぐにそのブランチでの作業を開始します。ブランチの作成と移動には、主に2つのコマンドがあります。（git switchとgit checkout）

※古いバージョンのGitを使っている場合や、古いチュートリアルなどでは git checkout -b が使われています。

# 'feature/add-message' という名前のブランチを作成し、そこに移動 
git switch -c feature/add-message
# 古い書き方（非推奨）
git checkout -b feature/add-message 

ブランチ名には、feature/〇〇 (機能追加) や fix/〇〇 (バグ修正) のように、目的が分かるプレフィックスを付けると管理しやすくなります。

ブランチでの作業とコミット

新しいブランチでコードを修正し、通常通り git add と git commit を行います。このコミットは、現在いるブランチにのみ記録されます。

ブランチの切り替え (git checkout または git switch)

他のブランチ（例えば main）に戻るには以下のコマンドを使います。

git switch main
# 古い書き方（非推奨）
git checkout main 

ブランチの統合 (git merge)

あるブランチでの変更内容を、別のブランチ（通常は main）に取り込むには以下のコマンドを実行します。

# 現在いるブランチ (例: main) に、'feature/add-message' ブランチの変更を取り込む 
git merge feature/add-message

ブランチを実際に使ってみよう！

では、実際に操作しながら確認してみましょう！hello.py に新しいメッセージを追加する作業を、新しいブランチで行ってみます。

# feature/add-message ブランチで hello.py を以下のように変更
print("Hello, Git World!")
print("Learning branches is fun!") # この行を追加

# 1. feature/add-message ブランチを作成して移動
git switch -c feature/add-message

# 2. hello.py を変更してコミット
git add hello.py
git commit -m "Add a new message about branches"

# 3. main ブランチに戻る
git switch main
# (この時点では、main ブランチの hello.py は変更前のまま)

# 4. feature/add-message ブランチの変更を main に取り込む
git merge feature/add-message
# (成功すれば、main ブランチの hello.py にも新しいメッセージが追加される)

今回はコンフリクトなく git merge が成功し、main ブランチのファイルも無事更新されました。ブランチを使えば、試行錯誤が格段にしやすくなることを実感しました。これは積極的に使っていきたい機能です！

まとめ

今回は、Windows環境でバージョン管理ツールのGitと、コード共有プラットフォームのGitHubの基本的な使い方を、専門用語の解説も交えながら学んでみました。Git for Windowsのインストールから始め、リポジトリの作成、コミット、GitHubとの連携、そしてブランチ機能まで、試行錯誤しながら一通り体験することができました。

「リポジトリ」「コミット」「ブランチ」といった専門用語も、たとえ話を交えることで少しはイメージが掴めたでしょうか？ コマンド自体はシンプルでも、その裏にある概念を理解することが大切だと感じました。

まだまだGit/GitHubにはたくさんの機能があるようなので、これからもPythonやAIの学習と並行して、少しずつ使い方をマスターしていきたいと思います。この記事が、同じようにWindows環境でGit/GitHubをこれから学ぼうとしている方の、「なんだか難しそう…」という壁を少しでも低くするお手伝いができれば嬉しいです。