ゼロから実務まで学ぶGit・GitHub14ステップで、はじめてのコミットからチーム開発の現場まで

git --version

git config --global user.name "Takayuki Ueki"
git config --global user.email "you@example.com"

# 新しいリポジトリの最初のブランチ名を main にする（現在の標準）
git config --global init.defaultBranch main

# 日本語のファイル名が文字化けして表示されないようにする
git config --global core.quotepath false

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

# Windows の人
git config --global core.autocrlf true

# Mac / Linux の人
git config --global core.autocrlf input

cd ~/Desktop          # デスクトップに移動
mkdir git-practice    # 練習用フォルダを作る
cd git-practice       # その中に入る
pwd                   # 今いる場所を表示（Windowsでも Git Bash なら動きます）

  ①作業ツリー          ②ステージ            ③リポジトリ
（自分が編集する場所）  （記録する候補置き場）  （確定した履歴）

  file.txt を編集
        │
        │  git add file.txt
        └──────────────▶ 記録する候補に入れる
                              │
                              │  git commit -m "説明"
                              └──────────────▶ 履歴として確定

  ◀────────────────────────────────────────
        git log で見えるのは③だけ

cd ~/Desktop/git-practice
git init

echo "# 練習用リポジトリ" > README.md
git status

git add README.md     # 1つのファイルを入れる
git add .             # 今いる場所以下の変更をすべて入れる
git status

git commit -m "READMEを追加"

echo "このリポジトリはGitの練習用です。" >> README.md

git status                      # ① 今どこが変わったか確認
git diff                        # ② 何がどう変わったか確認
git add README.md               # ③ 記録する対象に入れる
git commit -m "READMEに説明文を追加"   # ④ 記録を確定
git log --oneline               # ⑤ 履歴を確認

git log                      # 詳しく表示（q キーで終了）
git log --oneline            # 1行ずつ、簡潔に
git log --oneline -5         # 最新の5件だけ
git log --oneline --graph --all   # 枝分かれを図で表示（最頻出）
git log --stat               # 変更されたファイルと行数も表示
git log -p                   # 変更内容そのものも表示
git log --author="Ueki"      # 特定の人のコミットだけ
git log --since="2週間前"     # 期間で絞る
git log --grep="ログイン"      # メッセージで検索
git log -- src/main.js       # 特定のファイルの履歴だけ

HEAD      今いるコミット（ふつうは最新）
HEAD~1    1つ前のコミット
HEAD~2    2つ前のコミット
HEAD~5    5つ前のコミット
8f2a91c   ハッシュで直接指定してもよい

diff --git a/README.md b/README.md
index 3b18e51..a1f9c33 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,3 @@
 # 練習用リポジトリ
-このリポジトリはGitの練習用です。
+このリポジトリはGitの学習用です。
+STEP 2まで進みました。

git show                     # 最新のコミットの内容
git show 8f2a91c             # 指定したコミットの内容
git show HEAD~2              # 2つ前のコミットの内容
git show 8f2a91c:README.md   # そのコミット時点のファイル全文を表示

git blame README.md
git blame -L 10,20 src/main.js    # 10〜20行目だけ

# ① まだ add していない編集を、最後のコミットの状態に戻す
git restore README.md
git restore .                 # すべてのファイルを戻す

# ② add したものをステージから降ろす（編集内容は消えない）
git restore --staged README.md

# メッセージだけ書き直す
git commit --amend -m "ログイン失敗時のエラー表示を修正"

# ファイルの入れ忘れを、直前のコミットに含める（メッセージは変えない）
git add forgot.js
git commit --amend --no-edit

# 直前のコミットを取り消すが、書いたコードは残す（いちばんよく使う）
git reset --soft HEAD~1

# 直前3つのコミットを1つにまとめ直したいとき
git reset --soft HEAD~3
git commit -m "ログイン機能を実装"

# 全部捨てて、最後のコミットの状態に完全に戻す（要注意）
git reset --hard HEAD

git log --oneline
git revert c4d7e2b            # 指定したコミットを打ち消すコミットを作る
git revert HEAD               # 直前のコミットを打ち消す
git revert --no-commit c4d7e2b  # 打ち消す内容を作るだけで、コミットはしない

git reflog

git reset --hard c4d7e2b      # 消したはずのコミットに戻る
# または、その状態を新しいブランチとして取り出す
git switch -c rescue c4d7e2b

# --- 秘密情報 ---
.env
.env.local
*.pem
*.key
credentials.json

# --- 依存パッケージ・生成物 ---
node_modules/
__pycache__/
*.pyc
.venv/
venv/
build/
dist/
*.log

# --- OS が勝手に作るファイル ---
.DS_Store
Thumbs.db

# --- エディタの設定 ---
.vscode/
.idea/

# --- データファイル（大きい・機微な情報を含む） ---
data/*.csv
!data/sample.csv        # ただし sample.csv だけは例外的に管理する

# --cached を付けると、Gitの管理から外れるだけで、手元のファイルは消えない
git rm --cached .env
git rm -r --cached node_modules/

echo ".env" >> .gitignore
git add .gitignore
git commit -m ".envをGit管理から除外"

git status --ignored          # 無視されているファイルも含めて表示
git check-ignore -v .env      # なぜ無視されたか、該当の行を表示する

DATABASE_URL=postgresql://user:password@localhost:5432/dbname
API_KEY=
SLACK_WEBHOOK_URL=
DEBUG=false

                    ┌─● E ── F  ← feature/login（新機能を開発中）
                    │
  A ── B ── C ── D ─┴────────────  ← main（いつでも動く状態を保つ）
                                        ▲
                                     今ここ

  ・main は「完成していて、いつ動かしても大丈夫」な状態を保つ
  ・新しい作業は枝を伸ばして行い、完成したら main に合流させる
  ・失敗したら、枝ごと捨てれば main は無傷

git branch                        # 今あるブランチの一覧（* が現在地）
git switch -c feature/login       # 作成して、そこへ移動する（最頻出）
git switch main                   # main に戻る
git switch -                      # 直前にいたブランチに戻る

# 古い書き方（同じ意味。資料によく出てきます）
git checkout -b feature/login
git checkout main

git switch -c feature/login

echo "<h1>ログイン</h1>" > login.html
git add login.html
git commit -m "ログイン画面の雛形を追加"

git log --oneline --graph --all

git switch main                   # ① 取り込む側（main）に移動する
git merge feature/login           # ② feature/login を main に取り込む
git branch -d feature/login       # ③ 用済みのブランチを消す

【Fast-forward】main が進んでいない場合
  before:  A ── B ──● C (main)
                     └─ D ── E (feature)
  after:   A ── B ── C ── D ── E (main, feature)   ← 枝分かれの跡が残らない

【マージコミット】両方が進んでいる場合
  before:  A ── B ── C ── F (main)
                     └─ D ── E (feature)
  after:   A ── B ── C ── F ─── M (main)   ← M が「合流の記録」
                      └─ D ── E ─┘

# 早送りできる場合でも、あえて合流の記録を残す
git merge --no-ff feature/login

# 逆に、早送りできるときだけマージを許す（履歴を一直線に保ちたい現場向け）
git merge --ff-only feature/login

git branch                        # 手元のブランチ一覧
git branch -a                     # リモートのものも含めて一覧
git branch --merged               # すでにマージ済みのブランチ（消してよい候補）
git branch --no-merged            # まだマージしていないブランチ

git branch -d feature/login       # マージ済みのブランチを削除（安全）
git branch -D feature/login       # 強制削除（マージしていなくても消す）
git branch -m new-name            # 今いるブランチの名前を変える

          ┌─ 田中さん: 3行目を「価格: 1200円」に変更
  共通の元 ─┤
          └─ 自分　　: 3行目を「価格: 980円」に変更

  → Gitは「3行目をどちらにすればいいか」わからない → コンフリクト

# 準備：main で price.txt を作る
git switch main
echo "価格: 1000円" > price.txt
git add price.txt && git commit -m "価格ファイルを追加"

# ブランチ側で変更
git switch -c feature/price
echo "価格: 980円" > price.txt
git commit -am "価格を980円に変更"

# main 側でも同じ行を変更
git switch main
echo "価格: 1200円" > price.txt
git commit -am "価格を1200円に変更"

# マージするとコンフリクトする
git merge feature/price

<<<<<<< HEAD
価格: 1200円
=======
価格: 980円
>>>>>>> feature/price

価格: 980円

git status                # まだ解決していないファイルが一覧される
git add price.txt         # 「解決しました」という意思表示が add
git commit                # メッセージは自動で用意される。そのまま保存でよい

git merge --abort         # マージを中止して、始める前の状態に戻す
git rebase --abort        # リベース中ならこちら
git cherry-pick --abort   # チェリーピック中ならこちら

git checkout --ours price.txt     # 今いる側（HEAD）の内容を採用
git checkout --theirs price.txt   # 取り込む側の内容を採用
git add price.txt

  自分のパソコン                    GitHub
  ┌──────────────┐               ┌──────────────┐
  │ ローカル      │  ── push ──▶  │ origin       │
  │ リポジトリ    │  ◀── pull ──  │ (リモート)    │
  └──────────────┘               └──────────────┘
                                        │ clone
                                        ▼
                                  同僚のパソコン

# Mac: brew install gh / Windows: winget install GitHub.cli
gh auth login
# → GitHub.com / HTTPS / ブラウザで認証、と選んでいくだけ

# ① 鍵を作る（メールアドレスは自分のもの。パスフレーズは設定推奨）
ssh-keygen -t ed25519 -C "you@example.com"
# → 保存先を聞かれたら Enter でよい

# ② 公開鍵（.pub のほう）の中身を表示してコピーする
cat ~/.ssh/id_ed25519.pub

# ③ GitHub の Settings → SSH and GPG keys → New SSH key に貼り付ける

# ④ つながるか確認する
ssh -T git@github.com

# リモートを登録する（URLは自分のリポジトリのもの）
git remote add origin git@github.com:username/git-practice.git
# HTTPS の場合
# git remote add origin https://github.com/username/git-practice.git

git remote -v                     # 登録されたか確認
git push -u origin main           # 初回の push

git push                          # 手元の変更をGitHubへ送る
git pull                          # GitHub側の変更を手元に取り込む
git fetch                         # 取り込まずに、最新情報だけ確認する
git fetch --prune                 # 消えたリモートブランチの情報も整理する

git push -u origin feature/login  # 新しく作ったブランチを初めて送るとき

git clone git@github.com:username/project.git
git clone https://github.com/username/project.git
git clone https://github.com/username/project.git myfolder   # 別名で取り込む
git clone --depth 1 https://github.com/username/project.git  # 最新だけ（軽い）

git pull                          # まず相手の変更を取り込む
# （コンフリクトが出たら STEP 6 の手順で解決する）
git push                          # あらためて送る

# 売上集計ツール

毎月の売上CSVを読み込み、支店別の集計表を出力するツールです。

## 必要なもの
- Python 3.11 以上

## 使い方
pip install -r requirements.txt
python src/main.py data/sales.csv

## 設定
.env.example を .env にコピーし、APIキーを記入してください。

## 注意
- data/ の中身は機密情報のため、リポジトリには含めていません。

# ① 最新の main から始める（ここが重要）
git switch main
git pull

# ② 作業用ブランチを作る
git switch -c feature/user-search

# ③ 作業してコミット（こまめに）
git add .
git commit -m "ユーザー検索の入力欄を追加"

# ④ GitHubへ送る
git push -u origin feature/user-search

gh pr create --title "ユーザー検索機能を追加" --body "一覧画面に名前での絞り込みを追加しました。"
gh pr list                        # PRの一覧
gh pr view --web                  # ブラウザで開く
gh pr status                      # 自分に関係するPRの状況
gh pr checkout 42                 # 他人のPRを手元で動かしてみる

## 何をしたか
ユーザー一覧画面に、名前での絞り込み機能を追加しました。

## なぜ必要か
問い合わせ対応時に、一覧を目視で探すのに時間がかかっていたため。
関連: #123

## 動作確認したこと
- [x] 名前の一部で検索できる
- [x] 該当0件のときに「見つかりません」と表示される
- [x] 空欄のまま検索すると全件表示に戻る

## レビューで見てほしいところ
検索処理を画面側に書きましたが、サービス層に移すべきか迷っています。

## スクリーンショット
（画面の画像を貼る）

git add src/search.js
git commit -m "レビュー指摘: 検索処理をサービス層に移動"
git push                          # PRに自動で反映される

git switch main
git pull                              # マージされた内容を取り込む
git branch -d feature/user-search     # 手元のブランチを削除
git fetch --prune                     # 消えたリモートブランチの情報を整理

# ① GitHub上で Fork ボタンを押す
# ② 自分のアカウントに複製されたものを clone する
git clone git@github.com:myname/awesome-project.git
cd awesome-project

# ③ 本家を upstream として登録しておく（本家の更新を取り込むため）
git remote add upstream https://github.com/original/awesome-project.git
git remote -v

# ④ 本家の最新を取り込む
git fetch upstream
git merge upstream/main

# ⑤ ブランチを切って作業し、自分のフォークへ push → 本家へPRを出す
git switch -c fix/typo-in-readme
git push -u origin fix/typo-in-readme

① main はつねに「いつでもリリースできる」状態を保つ
② 作業は必ず main から新しいブランチを作って行う
③ こまめにコミットし、こまめに push する
④ 完成したら（あるいは相談したくなったら）PRを出す
⑤ レビューを受け、自動テストを通す
⑥ main にマージし、すぐにリリースする → ブランチは削除

## 概要
ログインに失敗しても、エラーメッセージが表示されない

## 再現手順
1. ログイン画面を開く
2. 存在しないメールアドレスを入力して「ログイン」を押す
3. 何も表示されず、画面がそのまま止まる

## 期待する動作
「メールアドレスまたはパスワードが違います」と表示される

## 環境
Chrome 131 / macOS 15.2

gh issue create --title "ログイン失敗時にエラーが出ない" --body "..."
gh issue list --assignee "@me"        # 自分に割り当てられた課題
gh issue view 123

形式:  種類(範囲): 要約

feat(auth): パスワード再設定機能を追加
fix(login): エラーメッセージが表示されない不具合を修正
docs(readme): 環境構築手順を追記
style: インデントを整形（動作に影響なし）
refactor(order): 注文処理を関数に分割
perf(search): 検索クエリのN+1問題を解消
test(user): ユーザー登録のテストを追加
chore(deps): ライブラリを最新版に更新
ci: テスト実行のワークフローを追加

# --- 朝 ---
git switch main
git pull                                  # 最新にする
git switch -c fix/456-login-error         # 課題番号入りのブランチ

# --- 午前 ---
git status
git diff
git add src/auth.js
git commit -m "fix(login): 認証失敗時にエラーを返すよう修正"

# --- 昼過ぎ ---
git switch main && git pull               # 他の人の変更を取り込む
git switch fix/456-login-error
git merge main                            # 自分のブランチを最新に追従させる

# --- 夕方 ---
git push -u origin fix/456-login-error
gh pr create --fill                       # PRを作成 → レビュー依頼

# --- 翌日、指摘を受けて ---
git add . && git commit -m "レビュー指摘: テストケースを追加"
git push                                  # → 承認 → マージ → ブランチ削除

git stash push -m "検索機能 作りかけ"   # 名前を付けて退避（推奨）
git stash                              # 名前なしでも可

git stash list                         # 棚上げしたものの一覧
git stash show -p stash@{0}            # 中身を確認する

git stash pop                          # 最新のものを取り出して、棚からも消す
git stash apply stash@{1}              # 指定のものを取り出す（棚には残す）
git stash drop stash@{0}               # 棚から消す
git stash clear                        # 全部消す（要注意）

git stash -u                           # 新規作成した未追跡ファイルも退避する

【merge した場合】合流の記録が残る
  A ── B ── C ──────── M (main)
        └─ D ── E ────┘

【rebase した場合】自分のコミットが作り直されて一直線になる
  A ── B ── C ── D' ── E' (feature)
                 ▲
        D と E は「別のコミット」として作り直される（ハッシュが変わる）

git switch feature/search
git fetch origin
git rebase origin/main            # main の最新の上に自分の作業を載せ直す

# コンフリクトが起きたら、1コミットずつ解決していく
git add 解決したファイル
git rebase --continue
git rebase --abort                # やっぱりやめる

git rebase -i HEAD~4              # 直近4つのコミットを整理する

pick 1a2b3c4 検索機能の骨組みを追加
squash 5d6e7f8 typo修正            ← 1つ上のコミットに吸収させる
squash 9a0b1c2 インデント修正        ← 同上
reword 3d4e5f6 検索結果の表示を追加   ← メッセージだけ書き直す

# 使える指示:
# pick   = そのまま使う
# reword = 内容はそのまま、メッセージだけ変える
# edit   = そこで一時停止して、内容を修正する
# squash = 1つ上のコミットに統合する（メッセージも統合）
# fixup  = 1つ上に統合する（このコミットのメッセージは捨てる）
# drop   = このコミットを削除する
# 上下の行を入れ替えると、コミットの順序も変わります

git pull --rebase

# 毎回この動きにしたい場合（多くの現場でおすすめ）
git config --global pull.rebase true

git switch main
git cherry-pick 7a2b9c1           # そのコミットの変更内容だけを持ってくる
git cherry-pick 7a2b9c1 3f8d2e5   # 複数まとめて
git cherry-pick a1b2c3d..e4f5g6h  # 範囲で指定

git tag v1.0.0                            # 軽量タグ
git tag -a v1.0.0 -m "初回リリース"        # 注釈付きタグ（実務ではこちら）
git tag                                   # 一覧
git show v1.0.0                           # 中身を確認

git push origin v1.0.0                    # タグをリモートに送る
git push --tags                           # すべてのタグを送る
git tag -d v1.0.0                         # 手元のタグを削除

git bisect start
git bisect bad                    # 今は壊れている
git bisect good v1.2.0            # このときは動いていた

# → Gitが中間のコミットに移動する。動作を確認して…
git bisect good                   # 動いた場合
git bisect bad                    # 壊れていた場合
# → これをくり返すと、原因のコミットが特定される

git bisect reset                  # 終了して元のブランチに戻る

git clean -n                      # 未追跡ファイルの削除対象を「確認だけ」する
git clean -fd                     # 未追跡のファイルとフォルダを削除（要注意）

git restore --source=HEAD~3 app.js    # 3つ前の状態のファイルだけを取り戻す

git worktree add ../hotfix main       # 同じリポジトリを別フォルダにも展開する
                                      # （ブランチを切り替えずに2つ同時に作業できる）

git shortlog -sn                      # 誰が何コミットしたかの集計
git log --since="1 month ago" --oneline | wc -l   # 直近1か月のコミット数

git config --global alias.st status           # 短縮名を作る
git config --global alias.lg "log --oneline --graph --all"
# → 以後 git st / git lg で使える

name: CI

# いつ動かすか
on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest        # どんな環境で動かすか

    steps:
      - name: リポジトリを取得する
        uses: actions/checkout@v4

      - name: Python を用意する
        uses: actions/setup-python@v5
        with:
          python-version: "3.12"

      - name: ライブラリを入れる
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt

      - name: 書き方を点検する
        run: ruff check .

      - name: テストを実行する
        run: pytest -v

name: Node CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [20, 22]     # 2つの版で同時に検証する

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: "npm"             # 依存パッケージを再利用して高速化

      - run: npm ci                # package-lock.json に忠実に入れる
      - run: npm run lint
      - run: npm test

      - name: デプロイする
        env:
          API_KEY: ${{ secrets.API_KEY }}
          SLACK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}
        run: ./scripts/deploy.sh

https://ユーザー名.github.io/リポジトリ名/

# ユーザー名.github.io という名前のリポジトリなら
https://ユーザー名.github.io/

![CI](https://github.com/username/repo/actions/workflows/ci.yml/badge.svg)

## 概要
<!-- 何をしたか、1〜2行で -->

## 背景・目的
<!-- なぜこの変更が必要か。関連するIssue: #  -->

## 変更点
-
-

## 動作確認
- [ ] ローカルで動作確認した
- [ ] テストを追加／更新した
- [ ] 既存の機能を壊していないことを確認した

## レビューで見てほしい点

---
name: 不具合の報告
about: 動作がおかしいときはこちら
labels: bug
---

## 起きていること

## 再現手順
1.
2.

## 期待する動作

## 環境
- OS:
- ブラウザ:

# 既定のレビュー担当
*                   @team-lead

# 特定のフォルダごとに担当を分ける
/src/frontend/      @frontend-team
/src/api/           @backend-team
/infra/             @sre-team
/docs/              @tech-writer

# 特に重要なファイルは複数人で見る
/src/auth/          @security-team @team-lead

version: 2
updates:
  - package-ecosystem: "pip"        # npm / pip / gradle / composer など
    directory: "/"
    schedule:
      interval: "weekly"
    open-pull-requests-limit: 5

  - package-ecosystem: "github-actions"
    directory: "/"
    schedule:
      interval: "monthly"

git tag -a v1.2.0 -m "検索機能を追加"
git push origin v1.2.0

gh release create v1.2.0 --generate-notes    # 変更点を自動でまとめてくれる
gh release list

# 全テキストファイルの改行を統一する
* text=auto eol=lf

# シェルスクリプトは必ずLF
*.sh text eol=lf

# バッチファイルは必ずCRLF
*.bat text eol=crlf

# バイナリとして扱う（差分を出さない）
*.png binary
*.xlsx binary

git switch main                   # 元に戻る（ここでのコミットは捨てられる）
git switch -c experiment          # ここでの作業をブランチとして残す

① 何よりも先に、その鍵・パスワードを無効化して作り直す（ローテーション）
     ← 履歴から消すより、こちらが先。すでに見られている前提で動く
② 会社のルールに従って報告する（隠さない）
③ .gitignore に追加し、以後同じことが起きないようにする
④ そのうえで、履歴からの削除を検討する

# まだ push していない直前のコミットなら、これで済む
git rm --cached .env
git commit --amend --no-edit

# すでに push 済みで、過去の履歴から完全に消したい場合
# （専用ツール git-filter-repo を使う。全履歴が書き換わる大手術）
pip install git-filter-repo
git filter-repo --path .env --invert-paths
git push --force --all

# 大きなファイルを扱う専用の仕組み（Git LFS）
git lfs install
git lfs track "*.psd"
git lfs track "*.mp4"
git add .gitattributes