Gitの基本的な使い方は？初心者向け完全ガイド

疑問

Gitの基本的な使い方を学びたいのですが、どのようなコマンドや操作が必要なのでしょうか？バージョン管理の基本から、ブランチやマージまで一緒に学んでいきましょう。

導入

Gitは、ソフトウェア開発において最も広く使用されているバージョン管理システムです。コードの変更履歴を追跡し、複数の開発者が協力して作業できるようにする強力なツールです。

Gitを使いこなすことで、コードの変更を安全に管理し、過去のバージョンに戻ったり、複数の機能を並行して開発したりすることが可能になります。本記事では、Gitの基本的な概念から、実践的なコマンド、ブランチ戦略まで、段階的に解説していきます。

解説

# グローバル設定（すべてのリポジトリに適用）
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# ローカル設定（現在のリポジトリのみに適用）
git config user.name "Your Name"
git config user.email "your.email@example.com"

# 設定の確認
git config --global user.name
git config --global user.email

# デフォルトのブランチ名をmainに設定
git config --global init.defaultBranch main

# カラー出力を有効化
git config --global color.ui auto

# エディタの設定（例：VS Code）
git config --global core.editor "code --wait"

# 改行コードの自動変換（Windows）
git config --global core.autocrlf true

# 改行コードの自動変換（Mac/Linux）
git config --global core.autocrlf input

# すべての設定を確認
git config --list

# プロジェクトディレクトリに移動
cd my-project

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

# リポジトリが初期化されたことを確認
ls -la  # .gitディレクトリが作成されていることを確認

# HTTPSを使用してクローン
git clone https://github.com/username/repository.git

# SSHを使用してクローン
git clone git@github.com:username/repository.git

# 特定のディレクトリ名でクローン
git clone https://github.com/username/repository.git my-project

# クローン後、ディレクトリに移動
cd repository

# ファイルの状態を確認
git status

# より詳細な情報を表示
git status -v

# 短縮形式で表示
git status -s

# ファイルの変更内容を確認
git diff

# ステージングエリアの変更内容を確認
git diff --staged

# 特定のファイルを追加
git add filename.txt

# 複数のファイルを追加
git add file1.txt file2.txt

# すべての変更を追加
git add .

# 特定の拡張子のファイルを追加
git add *.js

# インタラクティブモードで追加
git add -i

# コミットメッセージを指定してコミット
git commit -m "Add new feature"

# エディタを開いてコミットメッセージを入力
git commit

# すべての変更をステージングしてコミット（新規ファイルは除く）
git commit -a -m "Update existing files"

# 直前のコミットメッセージを変更
git commit --amend -m "New commit message"

# 良い例
# 1行目: 簡潔な要約（50文字以内）
# 2行目: 空行
# 3行目以降: 詳細な説明（必要に応じて）

git commit -m "Add user authentication feature

- Implement login functionality
- Add password validation
- Create user session management"

# 悪い例（避けるべき）
git commit -m "fix"
git commit -m "update"
git commit -m "changes"

# 基本的なコミット履歴
git log

# 1行形式で表示
git log --oneline

# グラフ形式で表示
git log --graph --oneline --all

# 最近の5件のみ表示
git log -5

# 特定のファイルの履歴を表示
git log filename.txt

# 作者ごとに表示
git log --author="Author Name"

# 日付範囲で絞り込み
git log --since="2024-01-01" --until="2024-12-31"

# 最新のコミットを表示
git show

# 特定のコミットを表示
git show commit-hash

# コミットの統計情報を表示
git show --stat commit-hash

# コミットの変更内容のみを表示
git show --name-only commit-hash

# 特定のファイルの変更を取り消す
git checkout -- filename.txt
# または
git restore filename.txt

# すべての変更を取り消す
git checkout -- .
# または
git restore .

# 特定のファイルをステージングから取り消す
git reset HEAD filename.txt
# または
git restore --staged filename.txt

# すべてのファイルをステージングから取り消す
git reset HEAD

# 最新のコミットを取り消す（変更は保持）
git reset --soft HEAD~1

# 最新のコミットを取り消す（変更も取り消す）
git reset --hard HEAD~1

# 特定のコミットまで戻る
git reset --hard commit-hash

# コミットを取り消す新しいコミットを作成（安全）
git revert HEAD

# 特定のコミットをrevert
git revert commit-hash

# ブランチの一覧を表示
git branch

# 新しいブランチを作成
git branch feature-branch

# ブランチを作成して切り替え
git checkout -b feature-branch
# または
git switch -c feature-branch

# リモートブランチから新しいブランチを作成
git checkout -b local-branch origin/remote-branch

# ブランチを切り替え
git checkout branch-name
# または
git switch branch-name

# 前のブランチに戻る
git checkout -
# または
git switch -

# マージ先のブランチに切り替え
git checkout main

# ブランチをマージ
git merge feature-branch

# マージコミットを作成せずにマージ（fast-forward）
git merge --ff-only feature-branch

# マージコミットを常に作成
git merge --no-ff feature-branch

# マージを取り消す
git merge --abort

# ローカルブランチを削除
git branch -d branch-name

# 強制削除（マージされていないブランチも削除）
git branch -D branch-name

# リモートブランチを削除
git push origin --delete branch-name

# リモートリポジトリを追加
git remote add origin https://github.com/username/repository.git

# リモートリポジトリの一覧を表示
git remote

# リモートリポジトリの詳細を表示
git remote -v

# リモートリポジトリのURLを変更
git remote set-url origin https://github.com/username/new-repository.git

# リモートリポジトリを削除
git remote remove origin

# ローカルの変更をリモートにプッシュ
git push origin main

# 初回プッシュ時にupstreamを設定
git push -u origin main

# リモートの変更を取得（マージしない）
git fetch origin

# リモートの変更を取得してマージ
git pull origin main

# すべてのリモートブランチを取得
git fetch --all

# リモートブランチを確認
git branch -r

# 変更をstashに保存
git stash

# メッセージを付けてstashに保存
git stash save "Work in progress"

# stashの一覧を表示
git stash list

# 最新のstashを適用
git stash apply

# 特定のstashを適用
git stash apply stash@{0}

# stashを適用して削除
git stash pop

# stashを削除（適用しない）
git stash drop stash@{0}

# すべてのstashを削除
git stash clear

# マージを実行（コンフリクトが発生）
git merge feature-branch

# コンフリクトが発生したファイルを確認
git status

# コンフリクトを解決後、ファイルをステージング
git add conflicted-file.txt

# マージを完了
git commit

# マージを取り消す
git merge --abort

# コンフリクトマーカーの例:
# <<<<<<< HEAD
# 現在のブランチの内容
# =======
# マージするブランチの内容
# >>>>>>> feature-branch

# ファイルをGitから削除（ファイルシステムからも削除）
git rm filename.txt

# ファイルをGitから削除（ファイルシステムには残す）
git rm --cached filename.txt

# ディレクトリを再帰的に削除
git rm -r directory-name

# 削除をコミット
git commit -m "Remove file"

# 依存関係
node_modules/
vendor/

# ビルド成果物
dist/
build/
*.class
*.jar
*.war

# 環境設定ファイル
.env
.env.local
*.log

# IDEの設定ファイル
.vscode/
.idea/
*.swp
*.swo
*~

# OS固有のファイル
.DS_Store
Thumbs.db

# 一時ファイル
*.tmp
*.temp
*.cache

# 1. 小さなコミットを心がける
# 関連する変更を1つのコミットにまとめる

# 2. 意味のあるコミットメッセージを書く
# 何を変更したか、なぜ変更したかを明確に

# 3. 定期的にプッシュする
# 作業を失わないように、定期的にリモートにプッシュ

# 4. ブランチを活用する
# 機能ごとにブランチを作成し、メインブランチを保護

# 5. プルする前にコミット
# リモートの変更を取得する前に、ローカルの変更をコミット

# 6. .gitignoreを適切に設定
# 不要なファイルを追跡しないようにする

# 1. 最新の状態を取得
git checkout main
git pull origin main

# 2. 機能ブランチを作成
git checkout -b feature/new-feature

# 3. ファイルを編集して変更をコミット
git add .
git commit -m "Add new feature"

# 4. 定期的にリモートにプッシュ
git push -u origin feature/new-feature

# 5. 作業を続ける
# ... ファイルを編集 ...
git add .
git commit -m "Update feature"
git push

# 6. メインブランチに戻ってマージ
git checkout main
git pull origin main
git merge feature/new-feature

# 7. マージをリモートにプッシュ
git push origin main

# 8. 機能ブランチを削除
git branch -d feature/new-feature
git push origin --delete feature/new-feature

# 1. バグ修正ブランチを作成
git checkout -b fix/bug-description

# 2. バグを修正してコミット
git add .
git commit -m "Fix: description of the bug fix"

# 3. リモートにプッシュ
git push -u origin fix/bug-description

# 4. メインブランチにマージ
git checkout main
git pull origin main
git merge fix/bug-description
git push origin main

まとめ

Gitは、ソフトウェア開発において不可欠なバージョン管理システムです。基本的なワークフローは、ファイルを編集→git addでステージング→git commitでコミット→git pushでリモートにプッシュという流れです。

ブランチを活用することで、複数の機能を並行して開発でき、安全にコードを管理できます。小さなコミットを心がけ、意味のあるコミットメッセージを書くことで、後から履歴を追跡しやすくなります。

実践的なプロジェクトで積極的にGitを使用し、日々の開発に組み込むことで、自然と使いこなせるようになります。