Gitの導入と最初の設定 — 入れただけでは事故る3項目

Gitの導入と初期設定。コードの書類と枝分かれした履歴、設定の歯車と鍵。

Git はコードの変更履歴を残す道具です。「いつ・誰が・どこを・なぜ変えたか」が全部残るので、壊しても戻せるようになります。

前回: 初期状態のPCに入れるのは3つだけ — 何を入れないかの話 このサイトの方針は はじめに にあります。 環境そのものを整えた回は 開発を始める前にPCの性能を確認する手順|メモリ・CPU・ディスクの見方 です。

自分がこれを本気で欲しいと思ったのは、設定ファイルを1行いじってサイトが真っ白になったときでした。何を変えたか思い出せないというのが一番怖い。Git があれば、その1行が何だったか一発で分かります。

ただ、Git は入れただけだと後で確実に事故ります。この記事では入れ方に加えて、最初にやっておくべき設定3つを扱います。自分の環境を確認したら、そのうち2つが未設定でした。

対象レベル: PC入門 / 区分: 必修

目次

この記事でわかること

  • Git を入れただけでは事故ること、その3項目
  • core.autocrlf を設定しないと何が起きるか
  • add と commit が分かれている理由
  • PowerShell が BOM付きでファイルを書くという罠

この記事でやること

  1. Git を winget で入れる
  2. 最初にやるべき設定4つを入れる
  3. 練習用フォルダで、実際に履歴を1つ作る
  4. ファイルを書き換えて、Gitが変化を検知するところまで確認する

先に知る言葉

この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。

言葉意味
Gitファイルの変更履歴を残す道具。「いつ・誰が・どこを・なぜ変えたか」が残り、壊しても前の状態に戻せる
リポジトリGit が履歴を保管しているフォルダのこと。git init を打つと .git が作られ、そこから履歴が貯まり始める
コミット「この時点の状態」を履歴に1つ確定させる操作、およびその1件。メモ書き(メッセージ)を必ず添える
ブランチ作業の枝。本流を壊さずに別の作業を進めるためのもので、最初の1本の名前が master か main かがここでの争点
GitHubGit の履歴をインターネット上に置いて共有できるサービス。手元の Git とは別物で、この回ではまだ使わない
BOM(Byte Order Mark)ファイルの先頭に付く「この文字コードですよ」という見えない3バイトの目印。設定ファイルに付くと動かなくなることがある

① 入っているかを確認する

まず PowerShell で、そもそも入っているかを見ます。

PowerShell
PS> git --version

入っていれば、こう出ます。

git version 2.48.1.windows.1

[スクリーンショット: 01_git_version.png] PowerShell で git --version を実行した結果を撮ってください。入っていない場合は、そのエラー画面でも構いません(「入っていない状態」も記録として価値があります)。

用語 'git' は認識されません のようなエラーが出たら、入っていません。次へ進んでください。

② インストールする

Windows 11 なら winget が最初から入っているので、コマンド1行です。

PowerShell
PS> winget install --id Git.Git -e

-e は「IDが完全一致するものだけ入れる」という意味です。付けないと、似た名前の別のパッケージを掴む可能性があります。

インストールが終わったら、PowerShell を一度閉じて開き直してください。

ここは自分も引っかかりました。開いたままだと git --version がまだ「認識されません」と言います。パスが読み込まれるのはウィンドウを開いた瞬間だけなので、後から入れたものは新しいウィンドウでないと見えません。

開き直して git --version が出れば、インストールは完了です。

③ 最初にやるべき設定 — ここからが本題

Git は入れた直後、ほぼ何も設定されていない状態です。このまま使い始めると後で困ります。

いま何が設定されているかは、これで全部見えます。

PowerShell
PS> git config --global --list

自分の場合はこうでした。

user.name=yourname
user.email=you@example.com

2行しかありません。 必要な設定はこれで足りていませんでした。

設定1: 名前とメールアドレス(これは入っていた)

PowerShell
PS> git config --global user.name "あなたの名前"
PS> git config --global user.email "あなたのメールアドレス"

これは変更履歴に残る署名です。「誰が変えたか」の「誰」がここになります。

設定していないと、最初に記録を残そうとしたときにエラーで止まります。Gitが動かないので、これは嫌でも気づけます。

問題は残りの2つです。設定していなくてもエラーが出ないので、気づかないまま進んで、あとで面倒なことになります。

設定2: 改行コード(未設定でした)

確認します。

PowerShell
PS> git config --global core.autocrlf

自分の結果は空っぽでした。--global には何も設定されていません。

これが何の問題かというと、WindowsとMac/Linuxで「改行」の表し方が違うからです。

OS改行の表し方
WindowsCRLF(2文字)
Mac / LinuxLF(1文字)

何も設定しないでいると、1文字も直していないファイルが「全行変更した」と表示されるという現象が起きます。改行コードだけが違うせいで、Gitが「全部書き換わった」と判断するためです。(Git for Windows をインストーラの既定のまま入れた場合は、Git 全体の設定(system)に core.autocrlf=true が入っています。実際に効いている値と出どころは git config --show-origin core.autocrlf で確かめられます)

複数人で作業するとき、あるいは Mac の人と同じコードを触るときに必ず踏みます。

Windows での推奨設定はこれです。

PowerShell
PS> git config --global core.autocrlf true

意味は「手元では Windows 式(CRLF)で扱い、記録するときは Linux 式(LF)に直す」です。世界の標準は LF なので、そちらに合わせて保存し、手元では Windows で扱いやすい形にする、という折衷案になります。

設定3: 最初のブランチ名(未設定でした)

これも確認します。

PowerShell
PS> git config --global init.defaultBranch

やはり空っぽでした。

ブランチというのは作業の枝のことです。Git は新しく管理を始めるとき、最初の枝に名前を付けます。設定していないと master になります。

これは後半で実際に確認できます。未設定のまま記録を作ったら、こう出ました。

[master (root-commit) 4ef305f] メモを追加
 ↑ここ
On branch master

現在は main を使うのが主流です(GitHub も 2020年から新規リポジトリは main が既定)。合わせておきます。

PowerShell
PS> git config --global init.defaultBranch main

名前が変わるだけに見えますが、GitHub に上げたときに「手元は master、向こうは main」というズレが起きなくなります。地味ですが、後から直すほうが面倒です。

3つまとめて

コピーして貼れば終わります。

PowerShell
PS> git config --global user.name "あなたの名前"
PS> git config --global user.email "あなたのメールアドレス"
PS> git config --global core.autocrlf true
PS> git config --global init.defaultBranch main

設定できたか確認します。

PowerShell
PS> git config --global --list

4行出ていれば完了です。

[スクリーンショット: 02_git_config.png] git config --global --list を実行して、4行出ている状態を撮ってください。メールアドレスが写るので、公開したくなければその部分を塗りつぶしてください。

④ 本当に動くか確かめる

設定して終わりにすると「入れたつもり」になります。実際に履歴を1つ作ってみます。

PowerShell
PS> cd $env:USERPROFILE\Desktop
PS> mkdir git-test
PS> cd git-test
PS> git init

git init は「このフォルダの変更履歴を残し始める」という宣言です。こう出れば成功です。

Initialized empty Git repository in C:/Users/.../Desktop/git-test/.git/

.git というフォルダが作られています。ここに履歴が全部入ります。 これを消すと履歴も消えます。

ファイルを1つ作って、記録してみます。

PowerShell
PS> "最初の1行" | Out-File -Encoding utf8 memo.txt
PS> git add memo.txt
PS> git commit -m "メモを追加"

3つのコマンドは、それぞれこういう意味です。

コマンドやっていること例えるなら
git add記録する対象を選ぶカゴに入れる
git commit選んだものを履歴に確定するレジを通す
-m "..."「なぜ変えたか」のメモを付けるレシートに書く

add と commit が分かれているのが最初の分かりにくさでした。「変更したファイル全部ではなく、今回の記録に含めるものだけ選べる」ための2段階になっています。

履歴を見ます。

PowerShell
PS> git log --oneline
4ef305f メモを追加

これが「履歴が残った」状態です。 短い英数字はコミットIDで、この時点のファイル全体に付けられた通し番号のようなものです。

[スクリーンショット: 03_git_log.png] git log --oneline の結果が出た画面を撮ってください。

変更を検知するところまで見る

もう一歩だけ。ファイルを書き換えて、Gitが気づくか見ます。

PowerShell
PS> "2行目を追加" | Out-File -Encoding utf8 -Append memo.txt
PS> git status
Changes not staged for commit:
        modified:   memo.txt

modified(変更あり)と言われました。 Git がファイルの変化を見張っている、ということが分かります。

どこが変わったかも見られます。

PowerShell
PS> git diff

実際の出力はこうでした。

diff --git a/memo.txt b/memo.txt
--- a/memo.txt
+++ b/memo.txt
@@ -1 +1,2 @@
 最初の1行
+2行目を追加

+ が付いた行が、追加された部分です。これが「いつ・どこを変えたか」の正体でした。

ここで変な文字が見えた

よく見ると、1行目の頭に  という見えない文字らしきものが付いています。これは BOM(Byte Order Mark) といって、「このファイルはUTF-8ですよ」という目印です。

実際にファイルの先頭3バイトを見ると、こうなっていました。

PowerShell
PS> [IO.File]::ReadAllBytes("memo.txt")[0..2] | ForEach-Object { $_.ToString('X2') }
EF
BB
BF

この EF BB BF が BOM の正体です。Windows に最初から入っている PowerShell(Windows PowerShell 5.1)の Out-File -Encoding utf8 は、BOM付きで書き込みます。(PowerShell 7 以降の utf8 は BOM 無しです)

普段は害がないのですが、設定ファイルやスクリプトに付くと動かなくなることがあります。プログラムが「1行目の先頭」を読もうとしたとき、見えない3バイトが邪魔をするためです。

練習では気にしなくて大丈夫ですが、実際のファイルは VS Code などのエディタで作るのが安全です。エディタは既定でBOM無しのUTF-8で保存します。

確認できたら、練習用フォルダは消して構いません。

PowerShell
PS> cd ..
PS> Remove-Item -Recurse -Force git-test

つまずいたところ

git commit でエディタが開いて閉じられなくなりました。 -m "メッセージ" を付け忘れると、Git はメッセージを書かせるためにエディタを開きます。それが vim だと、初見では閉じ方が分かりません。

脱出方法は Esc を押してから :q! と入力して Enter です。知らないと本気で困ります。

必ず -m を付けるのが、当面の回避策です。

まとめ

  • インストールは winget install --id Git.Git -e の1行。終わったらPowerShellを開き直す
  • 入れただけでは不十分。設定3つをやっておく
  • user.name / user.email … これは未設定だとエラーで止まるので気づける
  • core.autocrlf true … 未設定だと「1文字も変えていないのに全行変更扱い」になる
  • init.defaultBranch main … 未設定だと master になり、GitHubとズレる
  • 後ろの2つはエラーが出ない。 だから気づかないまま進んでしまう。自分も両方とも未設定でした
  • git add(カゴに入れる)→ git commit(レジを通す)の2段階。まとめて1つではない
  • Windows PowerShell 5.1 の Out-File -Encoding utf8 は BOM付きで書く(PowerShell 7 以降は BOM 無し)。git diff に見えない文字が出たらこれ
  • git commit は必ず -m "メッセージ" 付きで。付け忘れると vim から出られなくなる

GitHub に上げるのは、もう少し先です。 上げるものがまだ無いので、先に作業場所を用意します。

次は、Windows の仮想化ソフトをどれにするかを決めます。ここからしばらく、作業はすべて仮想マシンの中になります。


参考リンク


次に読む

この記事は 【第0段階】作業場所を作る の 9 / 18 本目です。

記事
← 前の記事初期状態のPCに入れるのは3つだけ — 何を入れないかの話
→ 次の記事Gitで変更を取り消す方法 — reset・revert・reflogの違いと使い分け

上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。

全体の順路は はじめに にあります。

roadmap.sh のどこをやっているか

Frontend/Backend/Git and GitHub›Version Control Systems
  • Basic Usage of Git
  • VCS Hosting — GitHub

この記事は、上の項目を実際に手を動かして確かめる回です。

よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!

コメント

コメントする

目次