〜venv を除外しつつ、main ブランチで運用するまで〜

Flask の最小構成を作って動作確認したあと、
GitHub に Push するまでにやった Git 操作を、
自分用の備忘録としてまとめておきます。

同じように Flask や Python プロジェクトを始めるときの参考にもなるはず。

---

🔧 1. プロジェクトフォルダを作成して Git 初期化

まずは作業用フォルダを作り、Git を初期化。

mkdir ToDoApp
cd ToDoApp
git init

この時点ではまだ何もコミットしていない状態。

---

🐍 2. 仮想環境（venv）を作成

Python プロジェクトでは仮想環境を作るのが基本。

python -m venv venv

GitHub に上げる必要はないので、後で .gitignore に追加する。

---

▶ 3. 仮想環境を有効化して Flask をインストール

source venv/Scripts/activate
pip install flask

---

🧱 4. Flask の最小構成を作成

ToDoApp/
├── app.py
├── templates/
│   └── index.html
└── requirements.txt

動作確認：

python app.py

---

📄 5. .gitignore を設定（venv を除外）

GitHub の Python テンプレートを使用したため、
venv/ はすでに .gitignore に含まれている。

そのため 追加のコミットは不要。

---

🌿 6. GitHub にリポジトリを作成

GitHub 上で空のリポジトリを作成（README なし推奨）。

---

🔗 7. リモートリポジトリを登録

git remote add origin https://github.com/ユーザー名/ToDoApp.git

---

🌱 8. ブランチ名を master → main に変更

GitHub のデフォルトが main のため、ローカルも合わせる。

git branch -m master main

---

📦 9. 初回コミットを作成

git add .
git commit -m "initial commit"

---

🔄 10. GitHub 側の履歴と統合（必要な場合）

GitHub が自動生成したファイルがある場合、
履歴が衝突するため pull が必要。

git pull origin main --allow-unrelated-histories

---

🚀 11. GitHub に push（初回）

git push -u origin main

これでローカルの main と GitHub の main が同期される。

---

🎉 まとめ

今回の流れで学んだポイントは以下の通り。

• venv は GitHub に上げない（.gitignore で除外）
• GitHub のデフォルトは main → ローカルも main に統一
• 初回 push で “non-fast-forward” が出たら pull で統合
• requirements.txt があれば環境は再現できる

この一連の流れを覚えておけば、
次に Flask や Python プロジェクトを作るときもスムーズに進められる。

---