Git・GitHub入門ガイド｜add・commit・pushからブランチ運用まで初心者向けに解説

テスト自動化のコードを書き始めたら、次に必要になるのが Git と GitHub の知識です。バージョン管理・チーム共有・CI/CD 連携のすべてが Git を中心に動きます。コマンドを1行ずつ確認しながら、最初に覚えるべき操作を整理します。

📌 この記事の対象読者

📖 この記事を読むとできること

筆者は複数のプロジェクトで Python × Selenium・Playwright・pytest を使ったテスト自動化コードを Git で管理し、GitHub Actions と連携してきました。
本記事では、「コマンドは覚えたけど何をやっているか分からない」という初心者がつまずきやすいポイントを先回りして説明します。

Git と GitHub は何が違うのか

最初に混乱しやすい点を整理します。

Git なしでは GitHub は使えません。
まず Git をインストールして、ローカルで履歴管理を覚えてから GitHub に接続する、という順番で進めます。

① Git をインストールする

Windows の場合

ブラウザで git-scm.com/download/win にアクセスしてインストーラーをダウンロード・実行します。
設定は基本的にデフォルトのままで問題ありません。「Choosing the default editor used by Git」では「Use Visual Studio Code」を選ぶと後で便利です。

Mac の場合

Mac には Git が最初から入っていることが多いです。ターミナルで以下を実行して確認します。

git --version

バージョンが表示されれば OK です。入っていない場合は Homebrew でインストールします。

brew install git

② Git の初期設定をする

Git をインストールしたら、最初に名前とメールアドレスを設定します。これは commit（変更の記録）に「誰が変更したか」を紐づけるための設定で、一度だけ行えばOKです。

# 名前の設定（GitHub のユーザー名と合わせると分かりやすい）
git config --global user.name "Your Name"

# メールアドレスの設定（GitHub に登録したアドレス）
git config --global user.email "your@email.com"

# 設定を確認する
git config --list

③ 基本ワークフロー：add → commit → push

Git の日常的な操作はこの3ステップで成り立っています。

実際の手順

1. リポジトリを作成する（初回のみ）

# プロジェクトフォルダに移動
cd my-test-project

# Git リポジトリを初期化する
git init

git init を実行すると、フォルダ内に .git という隠しフォルダが作成されます。これが Git の履歴データベースです。

2. 現在の状態を確認する

git status

git status は「今何が変わっているか」を確認するコマンドです。迷ったらとりあえず git status。 作業中に何度でも実行できます。

3. ファイルをステージングする（add）

# 個別ファイルを追加（最初は一つずつ確認しながらやると安心）
git add test_sample.py

# 全ファイルをまとめて追加（慣れてきたら）
git add .

4. 変更を記録する（commit）

# -m でコミットメッセージを書く
git commit -m "add: login test"

5. GitHub に push する（初回）

GitHub でリポジトリを作成したあと（github.com でログインして「New repository」から作成）、以下のコマンドで接続します。

# GitHub リポジトリを origin として登録（URL は自分のリポジトリに合わせる）
git remote add origin https://github.com/yourusername/my-test-project.git

# 現在のブランチ名を確認する
git branch
# → 「main」と表示されれば OK
# → 「master」と表示された場合は以下で main に変更する
git branch -M main

# main ブランチを GitHub に push
git push -u origin main

2回目以降は git push だけで OK です。

④ .gitignore で不要ファイルを除外する

.gitignore は「Git で管理しないファイル・フォルダ」を指定するファイルです。
テスト自動化プロジェクトで必ず除外すべきものがあります。

プロジェクトのルートに .gitignore ファイルを作成して以下を貼り付けます。

# .gitignore（テスト自動化プロジェクト用）

# ⚠️ 環境変数・機密情報（最優先で除外）
.env
.env.*
*.secret

# 仮想環境
venv/
.venv/

# Python キャッシュ
__pycache__/
*.py[cod]
*.pyo

# pytest
.pytest_cache/
.coverage
htmlcov/

# ログ
*.log

# OS 生成ファイル
.DS_Store        # Mac
Thumbs.db        # Windows

# Allure レポート
allure-results/
allure-report/

# IDE 設定（チームで共有不要なもの）
.vscode/
.idea/

⑤ ブランチを使って安全に変更を加える

ブランチとは、メインのコードを汚さずに変更を試せる「作業用コピー」です。
テスト自動化コードを追加・変更するときは、必ずブランチを切って作業します。

# 現在のブランチを確認する
git branch

# 新しいブランチを作成して移動する（Git 2.23以降の推奨方法）
git switch -c feature/add-login-test
# 古いバージョンの Git では以下を使う
# git checkout -b feature/add-login-test

# 作業・add・commit（通常の操作）
git add .
git commit -m "add: login validation test for valid credentials"

# GitHub にブランチを push する
git push -u origin feature/add-login-test

# 作業完了後、main に戻ってマージする（ローカルマージの場合）
git checkout main
git merge feature/add-login-test

ブランチ名は feature/（新機能）や fix/（バグ修正）のプレフィックスをつけると、何のための変更か分かりやすくなります。

⑥ よく使うコマンド早見表

⑦ 次のステップ：GitHub Actions で CI/CD を動かす

Git と GitHub の基本が身についたら、次は GitHub Actions を使って pytest を自動実行することができます。
コードを push するたびにテストが自動で走る環境は、テスト自動化の醍醐味の一つです。

# GitHub Actions の設定ファイルを置く場所
.github/
└── workflows/
    └── test.yml   ← この YAML ファイルで CI を定義する

実務でよくはまるポイント

よくある質問（FAQ）

まとめ

Git の操作を覚えると、テスト自動化コードの管理が格段に楽になります。次のステップとして、GitHub Actions で push のたびに pytest を自動実行する環境を作ってみてください。それがテスト自動化の本来の形です。

最初はコマンドが多くて大変に感じるかもしれませんが、status → add → commit → push の流れを毎日繰り返すうちに自然に身につきます。