「ローカルで作ったプロジェクトをGitで管理したい」
「GitHubにアップしてバージョン管理したい」
そんな方向けに、ローカルプロジェクトをGitHubで管理するまでの基本手順を解説します。
今回は以下の流れで進めます。
- プロジェクトフォルダへ移動
- ローカルリポジトリを作成
- ファイルをステージング
- 初回コミット
- GitHubでリモートリポジトリ作成
- ローカルとリモートを紐づけ
- GitHubへpush
前提
- Gitがインストール済み
- GitHubアカウントを作成済み
① プロジェクトフォルダへ移動
まずは、Gitで管理したいプロジェクトのフォルダへ移動します。
cd プロジェクトファイルのディレクトリ名
例:
cd java-study
🔎 cdとは?
「change directory」の略で、指定したフォルダへ移動するコマンドです。
② ローカルリポジトリの作成
次に、そのフォルダをGit管理できる状態にします。
git init
🔎 git initとは?
「このフォルダをGitで管理します」と宣言するコマンドです。
実行すると、.gitという隠しフォルダが作成されます。
これがGitの管理データ本体です。
③ ファイルをステージング
次に、コミット対象のファイルを選択します。
git add .
🔎 git add .とは?
- add = 変更を記録対象に追加
- . = 「このフォルダ配下すべて」
つまり、
「今あるすべてのファイルをコミット対象にする」という意味です。
④ 初回コミット(ローカルへ保存)
git commit -m "コミットメッセージ"
例:
git commit -m "初回コミット"
🔎 git commitとは?
変更内容をローカルリポジトリに保存する操作です。
🔎 -mとは?
メッセージを付けるオプションです。
「何を変更したか」を簡潔に書きます。
例:
- 初回コミット
- ログイン機能追加
- バグ修正
⑤ GitHubでリモートリポジトリを作成
次に、GitHub上に保存先を作ります。
- GitHubにログイン
- 「New repository」をクリック
- リポジトリ名を入力
- 「Create repository」をクリック
⚠️ 注意
READMEや.gitignoreはこの時点では作成しない方が初心者には安全です(履歴衝突を防ぐため)。
⑥ ローカルとリモートを紐づけ
GitHubで作成したリポジトリのURLを使って紐づけます。
git remote add origin https://github.com/ユーザー名/リポジトリ名.git
例:
git remote add origin https://github.com/YoroshikuTaro1111/java-study.git
🔎 git remote add originとは?
- remote → 外部リポジトリ設定
- add → 追加
- origin → リモートの名前(慣例的に使用)
- URL → GitHub上の保存先
「origin」という名前でGitHubの保存先を登録する、という意味です。
⑦ GitHubへアップロード(push)
git push -u origin main
※ブランチ名が master の場合は master
全体の流れまとめ
cd プロジェクトフォルダ名
git init
git add .
git commit -m "初回コミット"
git remote add origin リモートURL
git push -u origin main
※補足 git push -u origin main と git push origin main の違い
私がよく分からなかったので調べてみました。
① git push origin main
git push origin main
意味:
「origin の main ブランチへ今だけ push する」
毎回このコマンドをフルで書く必要があります。
② git push -u origin main
git push -u origin main
-u は --set-upstream の略です。
意味:
「今後、このブランチは origin の main と紐づけますよ」という設定を追加します。
一度 -u を付けて実行すると、次回からは
git push
だけでOKになります。
🔥 結論
初回 push は:
git push -u origin main
2回目以降は:
git push
が最も効率的です。
まとめ
ローカルプロジェクトをGitHubで管理する基本手順は以下です。
- git init(Git管理開始)
- git add(変更を登録)
- git commit(ローカル保存)
- GitHubでリポジトリ作成
- git remote add(紐づけ)
- git push(アップロード)
最初はコマンドが多く感じますが、
慣れれば一連の流れとして自然に使えるようになります。