$Git Simulator
壊しても大丈夫。全部ブラウザの中だけで動いています

インストールと初期設定

シミュレーターで慣れたら、自分のパソコンで本物の Git を使ってみましょう。このページでは、インストールから GitHub に push できるようになるまでの流れをまとめます。

手順の細部は OS やツールのバージョンで変わることがあります。うまくいかないときは各公式ドキュメントも確認してください。

1. インストール

まず、すでに入っているか確認します。

git --version
# git version 2.xx.x のように表示されれば OK

入っていなければ、OS に合わせてインストールします。

OS主な方法
macOSターミナルで git --version を実行すると、Xcode Command Line Tools のインストールを促される。Homebrew を使っているなら brew install git
Windows公式サイト(git-scm.com)のインストーラ「Git for Windows」。Git Bash というターミナルも一緒に入る。winget install Git.Git でも可
Linuxディストリビューションのパッケージマネージャ(例: sudo apt install git、sudo dnf install git)

Windows のインストーラはたくさんの質問をしてきますが、迷ったら基本的に既定のままで大丈夫です。

2. 名前とメールアドレスを設定する

コミットには必ず作者情報が記録されます。最初に一度だけ設定します。

git config --global user.name "Taro Yamada"
git config --global user.email "taro@example.com"
git config --global init.defaultBranch main
  • メールアドレスは 公開リポジトリの履歴に残ります。GitHub では、本当のアドレスを隠すための noreply アドレスを設定画面で確認できます
  • GitHub のアカウントに登録したメールアドレスと一致させると、コミットが自分のアカウントに紐づいて表示されます

設定は git config --global --list で確認できます。

あわせて設定しておくと便利なもの

git config --global core.editor "code --wait"   # コミットメッセージを VS Code で書く
git config --global pull.rebase false           # pull の既定動作を merge に

core.editor を設定しないと、git commit(-m なし)や git rebase -i で Vim が開くことがあります。Vim から抜けるには Esc を押してから :q!(保存せず終了)または :wq(保存して終了)と入力します。

3. GitHub に接続する(認証)

GitHub への push には認証が必要です。GitHub のアカウントのパスワードをそのまま入力する方式は使えません。 主に次の方法があります。

方法 A: HTTPS + 資格情報マネージャ(手軽)

  • GitHub Desktop や VS Code など GUI ツールからサインインすると、多くの場合そのまま使えるようになります
  • Git for Windows には Git Credential Manager が同梱されており、初回の push でブラウザが開いてログインできます
  • macOS ではキーチェーンに資格情報が保存されます
  • コマンドだけで設定したい場合は、GitHub CLI(gh)の gh auth login を使う方法もあります

手動で入力を求められたときに使うのは、GitHub の設定画面で発行する Personal Access Token(PAT) です。トークンはパスワードと同じく秘密情報なので、他人に見せたりコードに書いたりしないでください。

方法 B: SSH 鍵

鍵のペアを作り、公開鍵を GitHub に登録する方法です。

ssh-keygen -t ed25519 -C "taro@example.com"   # 鍵を作る(パスフレーズの設定を推奨)
cat ~/.ssh/id_ed25519.pub                     # 公開鍵を表示 → GitHub の設定画面に登録
ssh -T git@github.com                         # 接続テスト
  • .pub が付いている方が 公開鍵(登録してよい)、付いていない方が 秘密鍵(絶対に渡さない)
  • SSH を使う場合、clone や remote の URL は git@github.com:ユーザー名/リポジトリ名.git の形になります

どちらを選んでも構いません。チームや学校で指定があればそれに従いましょう。

4. 最初のリポジトリ

新しく作る場合

mkdir my-project
cd my-project
git init
echo "# My Project" > README.md
git add README.md
git commit -m "最初のコミット"

# GitHub で空のリポジトリを作ってから
git remote add origin <リポジトリの URL>
git push -u origin main

既存のリポジトリに参加する場合

git clone <リポジトリの URL>
cd <リポジトリ名>
git switch -c feature/my-first-change

この先の流れは プルリクエストとチーム開発の流れ を参照してください。

5. Windows と macOS が混在するチームでの注意

改行コード

Windows は改行に CRLF、macOS / Linux は LF を使うのが伝統です。そのままだと「中身は同じなのに全行が変更扱い」になることがあります。

  • リポジトリに .gitattributes を置いて * text=auto と書くのが確実です
  • 個人設定としては、Windows で core.autocrlf true、macOS / Linux で core.autocrlf input がよく使われます

ファイル名の大文字・小文字

macOS と Windows は既定でファイル名の大文字・小文字を区別しません。readme.md を README.md に変えるだけのリネームが Git に認識されないことがあるので、git mv readme.md README.md を使います。

困ったときのチェックリスト

症状確認すること
command not found: gitインストールされているか。ターミナルを開き直したか
Author identity unknownuser.name / user.email を設定したか
push で Authentication failed / Permission deniedトークンや SSH 鍵が正しいか。そのリポジトリへの書き込み権限があるか
Permission denied (publickey)公開鍵を GitHub に登録したか。ssh -T git@github.com で確認
rejected ... fetch first先に git pull。詳しくは リモートリポジトリ
何もしていないのに全ファイルが変更扱い改行コードやファイルの権限(core.fileMode)の違い