GitHub

自分のプロジェクトを GitHub に公開する

git init から GitHub への初回 push までのステップバイステップガイド

この手順でできること

自分のパソコンで作ったプロジェクト（コード、ドキュメントなど）を GitHub にアップロードし、公開・共有・バックアップできる状態にします。

すでに Git 管理されていないフォルダが対象です。

GitHub にログインして New repository を開く

右上の「+」メニューから「New repository」をクリックします。
リポジトリ名と公開範囲を決める

リポジトリ名を入力し、Public か Private を選びます。
README の初期化は必ずオフ

「Initialize this repository with a README」のチェックは 外してください。ローカルに既にファイルがあるため、チェックを入れると後で競合します。
Create repository をクリック

空のリポジトリが作成され、接続用の URL が表示されます。

プロジェクトのフォルダに移動

ターミナルで cd を使って対象フォルダに入ります。
git init を実行

フォルダが Git リポジトリになります。.git/ という隠しフォルダが作成されるだけで、既存のファイルには影響しません。

bash

cd ~/my-project
git init

git add . で全ファイルをステージング

フォルダ内のすべての変更をコミット対象に含めます。.gitignore に書いたファイルは自動的に除外されます。
git commit -m "first commit" で最初のコミットを作成

コミットメッセージは「first commit」や「initial commit」が一般的です。

bash

git add .
git commit -m "first commit"

GitHub のリポジトリページから URL をコピー

STEP 1 で作成したリポジトリのトップページに表示される HTTPS または SSH の URL をコピーします。
git remote add origin <URL> で接続先を登録

origin という名前でリモートが登録されます。これ以降 origin で GitHub を指定できます。

bash

# HTTPS の場合
git remote add origin https://github.com/user/my-project.git

# SSH の場合
git remote add origin git@github.com:user/my-project.git

git push -u origin main で初回プッシュ

-u（--set-upstream）はローカルの main ブランチと origin/main を紐付けるオプションです。ブランチ名が master の場合は main を master に読み替えてください。
2回目以降は git push だけで OK

初回に -u をつけておけば、次回からは引数なしで git push できるようになります。

bash

git push -u origin main

# 以降は git push だけでOK
git push

error: src refspec main does not match any

まだコミットしていません。STEP 3 の git add と git commit が実行できているか確認してください。
error: remote origin already exists

既に origin が登録されています。git remote set-url origin <URL> で URL を上書きするか、git remote remove origin で削除してから再登録します。
Permission denied

HTTPS の場合はユーザー名・パスワード（またはパーソナルアクセストークン）、SSH の場合は鍵の設定を確認してください。

bash

# origin の URL を変更する場合
git remote set-url origin https://github.com/user/my-project.git

# ブランチ名を確認
git branch

# main に改名したい場合
git branch -M main