GitとGitHubを使い始めるとき、最初に覚えるべき流れはそれほど多くありません。
基本となる流れは次のとおりです。
プロジェクト作成
│
▼
git init
│
▼
コミット
│
▼
GitHubでリポジトリ作成
│
▼
remote登録
│
▼
push
│
▼
別PC・共同開発なら
pull / clone
この記事ではWindows環境を例に、
- ローカルリポジトリ作成
- GitHubリポジトリ作成
- GitHubへPush
- GitHubからPull
- よく使うGitコマンド
までをまとめて解説します。
Gitとは
Gitはソースコードやファイルの変更履歴を管理するバージョン管理システムです。
変更履歴を保存できるため、
- 元に戻せる
- 変更内容を確認できる
- 複数人で開発できる
という大きなメリットがあります。
GitHubとは
GitHubはGitのリポジトリをインターネット上で管理するサービスです。
Gitはローカルだけでも利用できますが、GitHubを利用すると
- バックアップ
- 複数PCで同期
- チーム開発
- OSS公開
などが可能になります。
作業全体の流れ
フォルダ作成
↓
git init
↓
ファイル作成
↓
git add
↓
git commit
↓
GitHubでRepository作成
↓
git remote add origin
↓
git push
↓
git pull
1. プロジェクトフォルダを作成
例
C:\Users\username\projects\sample-app移動します。
cd C:\Users\username\projects\sample-app確認
pwdまたは
dir2. Gitリポジトリを初期化する
git init
結果
Initialized empty Git repository
これで
.git
フォルダが作成されます。
確認
dir /a
または
git status
3. READMEを作成する
echo # Sample Project > README.md
またはVS Codeで作成しても構いません。
例
# Sample Project
Gitの練習用プロジェクト
4. .gitignoreを作成する
Pythonの場合
.venv/
__pycache__/
*.pyc
.env
.vscode/
.idea/
dist/
build/
Node.jsの場合
node_modules/
.env
dist/
5. Gitの状態を確認する
git status例
Untracked files:
README.md
.gitignore
まだGitは管理していません。
6. Gitへ登録する
すべて登録
git add .
または
git add README.md
状態確認
git status
表示
Changes to be committed
7. 最初のコミット
git commit -m "Initial commit"
確認
git log
簡潔表示
git log --oneline
8. GitHubでリポジトリを作成
GitHubへログインし、
New Repository
を選択します。
設定例
Repository Name
sample-app
Visibility
Public
または
Private
READMEは作成しません。
既にローカル側で作成しているためです。
9. Remoteを登録する
GitHubに表示されるURLを使用します。
HTTPS
git remote add origin https://github.com/username/sample-app.git
SSH
git remote add origin git@github.com:username/sample-app.git
確認
git remote -v
表示
origin
origin
10. mainブランチへ変更
Gitのバージョンによってはmasterになるため
git branch -M main
確認
git branch
11. GitHubへPush
初回
git push -u origin main
以降
git push
だけでOKです。
12. GitHubからPull
git pull
他PCや共同開発では
初回
git pull origin main
13. Cloneする場合
新しいPCでは
git clone https://github.com/username/sample-app.git
移動
cd sample-app
14. 日常的な作業
変更確認
git status
差分
git diff
登録
git add .
コミット
git commit -m "機能追加"
送信
git push
取得
git pull
ブランチを作成する
一覧
git branch
新規作成
git branch feature/login
切り替え
git switch feature/login
または
git checkout feature/login
作成と同時に切り替え
git switch -c feature/login
ブランチをmainへ戻す
git switch main
マージする
git merge feature/login
Remoteを確認
git remote -v
Remoteを変更
git remote set-url origin https://github.com/username/newrepo.git
Remote削除
git remote remove origin
コミット履歴を見る
簡潔
git log --oneline
グラフ表示
git log --graph --oneline --all
変更内容を見る
作業中
git diff
ステージ済み
git diff --cached
ファイルを削除する
git rm sample.py
ファイル名変更
git mv old.py new.py
コミットを取り消す
直前
git reset --soft HEAD~1
完全削除
git reset --hard HEAD~1
Gitでよく使うコマンド一覧
| 目的 | コマンド |
|---|---|
| 状態確認 | git status |
| 登録 | git add . |
| コミット | git commit -m "message" |
| 送信 | git push |
| 取得 | git pull |
| 履歴 | git log --oneline |
| 差分 | git diff |
| ブランチ一覧 | git branch |
| ブランチ作成 | git switch -c feature |
| 切替 | git switch main |
| マージ | git merge feature |
| Remote確認 | git remote -v |
よくあるエラー
fatal: not a git repository
Git管理されていないフォルダです。
確認
pwd
または
dir /a
nothing to commit
変更がありません。
git status
で確認できます。
failed to push
リモートとの差分があります。
まず取得します。
git pull
その後
git push
Authentication failed
GitHub認証に失敗しています。
Personal Access TokenやSSHキーの設定を確認してください。
開発者が覚えておきたい基本サイクル
日々の開発では、次の5つを繰り返すだけで十分です。
編集
↓
git status
↓
git add .
↓
git commit -m "変更内容"
↓
git push
共同開発や複数PCで作業する場合は、作業開始時に git pull を実行して最新の状態を取得する習慣を付けると、コンフリクトや同期漏れを減らせます。
まとめ
Gitの基本操作は、実際には数個のコマンドを繰り返すだけです。
最初は git status を頻繁に実行して現在の状態を確認しながら操作すると理解が深まります。
基本的な流れを整理すると次のようになります。
git initでローカルリポジトリを作成するgit addとgit commitで変更履歴を保存する- GitHubでリモートリポジトリを作成する
git remote add originで関連付けるgit pushでGitHubへアップロードするgit pullやgit cloneを利用して別の環境と同期する
これらの操作を覚えておけば、個人開発からチーム開発まで幅広いプロジェクトでGitを活用できるようになります。
