LOCAL TOOL
Git
パソコン上でファイルの変更履歴を記録・管理するソフトウェア。
セーブデータを複数保存する仕組み
01
THE BIG PICTURE
まず知っておきたいこと
GitとGitHubは、名前は似ていますが役割が違います。
ONLINE SERVICE
GitHub
Gitで管理したファイルをインターネット上で保存・共有するサービス。
オンライン倉庫＋共同作業場所
01 GitHubから取得
→02 ブランチで作業
→03 add・commit
→04 push・PR
よく出てくる言葉
リポジトリ：Gitで管理するプロジェクトの入れ物。
ローカル：自分のパソコン上の場所。
リモート：GitHub上の場所。
履歴に関する言葉
コミット：変更をメッセージ付きで保存すること。
ブランチ：本体から分けた作業場所。
マージ：変更を別のブランチへ取り込むこと。
通信に関する言葉
push：ローカルのコミットをGitHubへ送る。
pull：GitHubの変更をローカルへ取得する。
PR：変更を取り込んでもらう依頼。
02
GET READY
使う前の準備
GitHubアカウントを作成
GitHubでアカウントを作り、メールアドレスを確認します。
名前とメールアドレスを設定
コミットに「誰が変更したか」を記録するための設定です。
git config --global user.name "あなたの名前"
git config --global user.email "GitHubに登録したメールアドレス"
git config --global --listGitHub CLI（gh）は任意です。
ghを使うとターミナルからPRの作成などもできます。GitHub CLI公式サイトからインストールし、gh auth loginでログインします。
03
YOUR WORKSPACE
ターミナルの基本
Gitコマンドは、作業するフォルダに移動してから実行します。
どこにいるか、何があるかを確認
# 現在いる場所
pwd
# フォルダの中身
ls
# フォルダへ移動 / 1つ上へ戻る
cd フォルダ名
cd ..Mac/LinuxとWindowsの違い
MacとLinuxはほぼ同じコマンドです。WindowsはPowerShellとGit Bashで書き方が変わります。
| やりたいこと | Mac / Linux / Git Bash | Windows PowerShell |
|---|---|---|
| 現在地を確認 | pwd | Get-Location |
| 一覧を見る | ls | Get-ChildItem |
| ファイルを作る | touch sample.txt | New-Item sample.txt -ItemType File |
| フォルダを作る | mkdir images | New-Item images -ItemType Directory |
| ファイルを削除 | rm sample.txt | Remove-Item sample.txt |
| フォルダを削除 | rm -r images | Remove-Item images -Recurse |
touch
空のファイルを作る
touch sample.txt。PowerShellでは New-Item を使います。
mkdir
フォルダを作る
mkdir images。親フォルダも作るときは mkdir -p。
rm
削除する
ごみ箱に入らないことがあります。対象を確認してから実行します。
04
UNDERSTAND THE CYCLE
ステージングを理解する
ステージングとは、次のコミットに入れる変更を一時的に選んでおくことです。
01作業中のファイルWorking tree
エディタで変更した直後
git add→
02ステージングエリア次のcommitに入れる変更
コミット前の確認ボックス
git commit→
03ローカル履歴コミット済み
パソコン内に保存された履歴
git push→
04GitHubリモートリポジトリ
チームと共有する場所
git addはGitHubへのアップロードではありません。
GitHubへ送るのは、commitの後にgit pushを実行したときです。
基本操作
git status
git diff
git add README.md
git diff --staged
git commit -m "説明を追加"ステージングを取り消す
ファイルの編集内容は残したまま、コミット対象から外せます。
git restore --staged README.md迷ったら、add後に git status と git diff --staged を確認しましょう。
05
WORK SAFELY
ブランチで作業する
mainで直接作業せず、機能追加や修正ごとに作業用ブランチを作ります。
CREATE AND SWITCH
作業ブランチを作る
機能追加はfeature、修正はfixなど、目的が分かる名前にします。
git switch -c feature/add-search
# 修正の場合
git switch -c fix/button-displayfeature/add-searchfix/header-layoutdocs/update-readme
確認と移動：
git branch で一覧、git switch main でmainへ移動。アスタリスクが現在のブランチです。06
SYNC YOUR WORK
GitHubと同期する
初めて取得する：clone
GitHubの「Code」からURLをコピーします。
git clone https://github.com/ユーザー名/リポジトリ名.git
cd リポジトリ名GitHubへ送る：push
初回だけ送信先を指定します。
git push -u origin feature/add-search
git push最新にする：pull
作業前にmainを更新する習慣をつけます。
git switch main
git pull origin mainfetchとの違い：
git fetch origin は情報だけ取得し、作業中のファイルを変更しません。内容を確認してから反映したいときに使います。手元のフォルダを新しくGitHubへ登録する
git init
git add .
git commit -m "最初のコミット"
git branch -M main
git remote add origin https://github.com/ユーザー名/リポジトリ名.git
git push -u origin main07
COLLABORATE
プルリクエストを作る
「このブランチの変更をmainに取り込んでください」と依頼する機能です。
01
作業する
ブランチでファイルを変更
02
保存する
add → commit → push
03
依頼する
GitHubでPRを作成
04
確認する
レビュー → 修正 → マージ
ON GITHUB
画面での手順
- 作業ブランチをpushする
- 「Compare & pull request」を選ぶ
- 変更先がmainか確認する
- タイトルと説明を書いて作成する
- レビュー後、必要なら同じブランチで修正してpushする
DESCRIPTION EXAMPLE
## 変更内容
- 検索ボタンを追加しました
## 確認方法
1. アプリを起動する
2. 「りんご」と入力する
3. 結果が表示されることを確認する
## 補足
- 関連Issue: #12MERGE
PRの変更をmainへ取り込むこと。マージ後は git switch main と git pull origin main でローカルも更新します。
08
WHEN THINGS COLLIDE
コンフリクトを解決する
同じファイルの同じ場所を複数人が変更すると、Gitがどちらを残すか判断できないことがあります。
<<<<<<< HEAD
自分の変更
=======
相手の変更
>>>>>>> main解決の手順
- ファイルを開く
- 残したい内容に編集する
- 3種類の印をすべて削除する
- 保存してaddする
- コミットしてpushする
git add 競合を解決したファイル
git commit -m "コンフリクトを解決"
git push09
KEEP SECRETS SAFE
.gitignore と .env
.gitignoreは「送らないリスト」
Gitで管理したくないファイルやフォルダを指定します。パスワード、APIキー、ログ、依存パッケージなどをGitHubへ送らないために使います。
# 実際の秘密情報
.env
.env.*
!.env.example
# 依存パッケージ
node_modules/
__pycache__/PRIVATE
.env
本物の値を入れる。GitHubへpushしない。
PORT=3000
API_KEY=実際のAPIキーSHAREABLE
.env.example
項目名とダミー値だけを共有する。
PORT=3000
API_KEY=ここに設定秘密情報を誤ってpushしたら、ファイルを消すだけでは不十分。
すぐにキーやパスワードを無効化・再発行し、管理者やチームへ報告します。
すでにGitが追跡している.envをローカルに残したまま外すには
git rm --cached .env。ただし、過去の履歴に残った秘密情報は別途対応が必要です。10
STOP AND CHECK
初心者が勝手にしてはいけないこと
| 操作 | 危険な理由 | まずすること |
|---|---|---|
rm -rf フォルダ | フォルダと中身を確認なしで削除 | lsで対象を確認 |
git push --force | GitHub上の他人のコミットを上書き | 通常の git pushを使い、必要なら許可を取る |
git reset --hard | 未コミットの変更を削除 | git statusとgit diffを確認 |
git clean -fd | Git管理外のファイルを削除 | git clean -ndで予定を確認 |
git clean -fdx | .gitignoreのファイルまで削除 | 原則として実行しない |
git branch -D 名前 | 未マージのブランチも強制削除 | git branch -d 名前を使う |
BEFORE YOU PANIC
間違えて実行しそうになったら
git status
git branch --show-current
git remote -v
git diffどのフォルダで、どのブランチに対して、何を削除・上書きするのか分からないなら、実行せずに相談します。
11
SEE IT IN ACTION
画面で見るGitHub
実際の画面で、どこをクリックするか確認できます。画面のレイアウトはGitHubの更新で変わることがあります。
12
KEEP THIS HANDY
最低限覚えるコマンド
git status現在の状態git clone URL初めて取得git pull最新に更新git switch -c 名前ブランチ作成git diff変更を確認git add ファイルステージングgit commit -m "..."履歴に保存git pushGitHubへ送信git log履歴を見るgit restore ファイル未コミット変更を戻すgit revert ID公開済み変更を打ち消すgit fetch origin情報だけ取得✓
困ったときの合言葉
まず git status。現在のブランチ、変更ファイル、コミット状況を確認してから次の操作を決めましょう。