GitHubアカウント
GitHubアカウントの作成については以下の記事で書いていますのでそちらを参照してください。なお、この説明はSSHキーの設定までが終わっていることを前提に記載していますのでSSHの設定まで終わらせてください。
GitHubのリポジトリ作成方法
まずはGitHubにログインし、上部のヘッダーにある「Repositories」を押下してください。すると以下の画面になります。
その後、画面の右上にある「New」アイコンをクリックします。画面が切り替わったら、まずは「Repository name」の欄に管理したいプロジェクトの名前を入力します。今回は例として my-repo と入力してみます。
次に、このリポジトリの公開設定を選びます。誰にでもコードを見られる状態にしておきたい場合は「Public」を、自分や特定のメンバーだけに見せたい場合は「Private」を選択してください。
いくつかの設定項目がありますが、今回はそのままページの一番下までスクロールし、「Create repository」と書かれた緑色のボタンをクリックします。これでGitHub上へのリポジトリの作成は完了です。
作成が完了すると、URLやいくつかのコマンドがずらりと書かれた画面が表示されます。この画面にあるURLやコマンドは、この後のステップでそのまま使用するため、ブラウザのタブは閉じずにそのまま開いておいてください。
ローカル環境での準備から最初のコミットまで
ここからは、パソコンのターミナルを開いて、手元のファイルをGitHubにアップロードするための操作を行っていきます。
1. プロジェクトのフォルダに移動する
まずは、Gitで管理したいプロジェクトが保存されているフォルダ（ディレクトリ）へと移動します。ターミナルを開き、cd ~/work/testのようにcd コマンドの後に目的のフォルダのパスを入力して実行してください。
2. ローカルリポジトリを初期化する
目的のフォルダに移動できたら、そのフォルダをGitの管理下に置くための初期化を行います。以下のコマンドを実行すると、フォルダ内に.gitが自動的に作成され、バージョン管理ができる状態になります。
git init
3. ファイルをステージングエリアに追加する
次に、Gitの管理対象としてファイルを登録します。今回は新しく README.md という名前のファイルを作成し、それをコミットの準備状態（ステージングエリア）に置いてみましょう。以下のコマンドを順番に実行します。
echo "# my-repo" >> README.md
git add README.md
もし、新しくファイルを作るのではなく、すでにそのフォルダ内にある既存のファイルをすべてまとめて登録したい場合は、ファイル名の代わりに.を使って以下のコマンドを実行してください。基本はこちらを利用すると楽です（場合によりますが…）
git add .
4. ファイルをコミットする
準備が整ったら、ファイルをローカルリポジトリに記録（コミット）します。git commit -m の後ろに、今回の変更内容がひと目でわかるメッセージを添えて実行します。今回は初めての記録なので、メッセージを "first commit" としています。
git commit -m "first commit"
GitHub（リモートリポジトリ）への接続とプッシュ
ローカル環境での記録が終わったら、最後に手元のリポジトリと先ほどGitHub上で作ったリポジトリを紐付け、ファイルをアップロード（プッシュ）します。
1. ブランチ名を main に変更する
現在のデフォルトブランチの名前を、GitHubの仕様に合わせて main という名前に切り替えます。以下のコマンドを実行してください。
git branch -M main
2. リモートリポジトリを登録する
続いて、GitHubのリポジトリと手元の環境を接続します。以下のコマンドを入力しますが、URLの部分は先ほどGitHubで作成した際に画面に表示されていた、自身のものへと書き換えて実行してください。
git remote add origin git@github.com:rikut0904/my-repo.git
3. GitHubへファイルをプッシュする
最後に以下のコマンドを実行して、ローカルでコミットした内容をGitHub上へ送信します。このとき -u オプションをつけておくことで、次回からは git push と入力するだけで簡単に送信できるようになります。
git push -u origin main
コマンドの実行が正常に終わり、エラーが出なければアップロードは成功です。確認のためにブラウザでGitHubのページをリロードしてみましょう。先ほど作成したファイルが無事に表示されていれば、すべての作業が完了となります。
おまけ：「ブランチ（Branch）」の重要性
今回の手順では、デフォルトである main というブランチに直接ファイルをプッシュしましたが、実際の開発（特に複数人で行うチーム開発）では、main ブランチに直接変更を加えていくことはほとんどありません。最後に、Gitの機能の一つである「ブランチ」について軽く触れておきます。
ブランチとは？
ブランチ（Branch）とは、日本語で「枝」という意味です。その名の通り、一本の太い幹（mainブランチ）から枝分かれさせるようにして、元のコードに影響を与えずに自分の作業専用のスペースを作ることができる機能です。
なぜチーム開発で重要なのか？
チーム開発においてブランチを分けるのには、主に3つの大きな理由があります。
-
本番環境のコードを守るため
mainブランチは、常に「いつでも本番に公開できる、エラーのない状態」に保つ必要があります。全員が直接mainを編集してしまうと、誰かが書いた未完成のコードやバグによって、システム全体が動かなくなってしまうリスクがあります。 -
複数の機能を並行して開発するため
例えば「Aさんはログイン機能の開発」「Bさんはデザインの修正」を同時に行う場合、それぞれのブランチ（feature/loginやfeature/designなど）を切り離して作業することで、お互いのコードがコンフリクトすることなく、自分の作業に集中できます。 -
レビューを経て安全に合流させるため
自分のブランチで作業が完了したら、GitHub上で「自分のコードをmainに合流させてください」というプルリクエストを送ります。チームの仲間にコードをレビューしてもらい、問題がないことを確認されてからマージさせることで、バグの混入を未然に防ぐことができます。
まとめ
1人の練習時は main だけで完結してしまいがちですが、「新機能を作るときは必ずブランチを分ける」という癖をつけておくと、実際の現場やチーム開発に参加したときにスムーズに動けるようになります。Gitの操作に慣れてきたら、ぜひ git checkout -b ブランチ名 を使ったブランチ開発にも挑戦してみてください！