インストールと初期設定
シミュレーターで慣れたら、自分のパソコンで本物の 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 unknown | user.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)の違い |