Git はコードの変更履歴を残す道具です。「いつ・誰が・どこを・なぜ変えたか」が全部残るので、壊しても戻せるようになります。
前回: 初期状態のPCに入れるのは3つだけ — 何を入れないかの話 このサイトの方針は はじめに にあります。 環境そのものを整えた回は 開発を始める前にPCの性能を確認する手順|メモリ・CPU・ディスクの見方 です。
自分がこれを本気で欲しいと思ったのは、設定ファイルを1行いじってサイトが真っ白になったときでした。何を変えたか思い出せないというのが一番怖い。Git があれば、その1行が何だったか一発で分かります。
ただ、Git は入れただけだと後で確実に事故ります。この記事では入れ方に加えて、最初にやっておくべき設定3つを扱います。自分の環境を確認したら、そのうち2つが未設定でした。
対象レベル: PC入門 / 区分: 必修
この記事でわかること
- Git を入れただけでは事故ること、その3項目
core.autocrlfを設定しないと何が起きるかaddとcommitが分かれている理由- PowerShell が BOM付きでファイルを書くという罠
この記事でやること
- Git を
wingetで入れる - 最初にやるべき設定4つを入れる
- 練習用フォルダで、実際に履歴を1つ作る
- ファイルを書き換えて、Gitが変化を検知するところまで確認する
先に知る言葉
この記事で初めて出てくる言葉です。 基本的な言葉は用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| Git | ファイルの変更履歴を残す道具。「いつ・誰が・どこを・なぜ変えたか」が残り、壊しても前の状態に戻せる |
| リポジトリ | Git が履歴を保管しているフォルダのこと。git init を打つと .git が作られ、そこから履歴が貯まり始める |
| コミット | 「この時点の状態」を履歴に1つ確定させる操作、およびその1件。メモ書き(メッセージ)を必ず添える |
| ブランチ | 作業の枝。本流を壊さずに別の作業を進めるためのもので、最初の1本の名前が master か main かがここでの争点 |
| GitHub | Git の履歴をインターネット上に置いて共有できるサービス。手元の Git とは別物で、この回ではまだ使わない |
| BOM(Byte Order Mark) | ファイルの先頭に付く「この文字コードですよ」という見えない3バイトの目印。設定ファイルに付くと動かなくなることがある |
① 入っているかを確認する
まず PowerShell で、そもそも入っているかを見ます。
入っていれば、こう出ます。
git version 2.48.1.windows.1
[スクリーンショット: 01_git_version.png] PowerShell で git --version を実行した結果を撮ってください。入っていない場合は、そのエラー画面でも構いません(「入っていない状態」も記録として価値があります)。
用語 'git' は認識されません のようなエラーが出たら、入っていません。次へ進んでください。
② インストールする
Windows 11 なら winget が最初から入っているので、コマンド1行です。
-e は「IDが完全一致するものだけ入れる」という意味です。付けないと、似た名前の別のパッケージを掴む可能性があります。
インストールが終わったら、PowerShell を一度閉じて開き直してください。
ここは自分も引っかかりました。開いたままだと
git --versionがまだ「認識されません」と言います。パスが読み込まれるのはウィンドウを開いた瞬間だけなので、後から入れたものは新しいウィンドウでないと見えません。
開き直して git --version が出れば、インストールは完了です。
③ 最初にやるべき設定 — ここからが本題
Git は入れた直後、ほぼ何も設定されていない状態です。このまま使い始めると後で困ります。
いま何が設定されているかは、これで全部見えます。
自分の場合はこうでした。
user.name=yourname
user.email=you@example.com
2行しかありません。 必要な設定はこれで足りていませんでした。
設定1: 名前とメールアドレス(これは入っていた)
これは変更履歴に残る署名です。「誰が変えたか」の「誰」がここになります。
設定していないと、最初に記録を残そうとしたときにエラーで止まります。Gitが動かないので、これは嫌でも気づけます。
問題は残りの2つです。設定していなくてもエラーが出ないので、気づかないまま進んで、あとで面倒なことになります。
設定2: 改行コード(未設定でした)
確認します。
自分の結果は空っぽでした。--global には何も設定されていません。
これが何の問題かというと、WindowsとMac/Linuxで「改行」の表し方が違うからです。
| OS | 改行の表し方 |
|---|---|
| Windows | CRLF(2文字) |
| Mac / Linux | LF(1文字) |
何も設定しないでいると、1文字も直していないファイルが「全行変更した」と表示されるという現象が起きます。改行コードだけが違うせいで、Gitが「全部書き換わった」と判断するためです。(Git for Windows をインストーラの既定のまま入れた場合は、Git 全体の設定(system)に core.autocrlf=true が入っています。実際に効いている値と出どころは git config --show-origin core.autocrlf で確かめられます)
複数人で作業するとき、あるいは Mac の人と同じコードを触るときに必ず踏みます。
Windows での推奨設定はこれです。
意味は「手元では Windows 式(CRLF)で扱い、記録するときは Linux 式(LF)に直す」です。世界の標準は LF なので、そちらに合わせて保存し、手元では Windows で扱いやすい形にする、という折衷案になります。
設定3: 最初のブランチ名(未設定でした)
これも確認します。
やはり空っぽでした。
ブランチというのは作業の枝のことです。Git は新しく管理を始めるとき、最初の枝に名前を付けます。設定していないと master になります。
これは後半で実際に確認できます。未設定のまま記録を作ったら、こう出ました。
[master (root-commit) 4ef305f] メモを追加
↑ここ
On branch master
現在は main を使うのが主流です(GitHub も 2020年から新規リポジトリは main が既定)。合わせておきます。
名前が変わるだけに見えますが、GitHub に上げたときに「手元は master、向こうは main」というズレが起きなくなります。地味ですが、後から直すほうが面倒です。
3つまとめて
コピーして貼れば終わります。
設定できたか確認します。
4行出ていれば完了です。
[スクリーンショット: 02_git_config.png] git config --global --list を実行して、4行出ている状態を撮ってください。メールアドレスが写るので、公開したくなければその部分を塗りつぶしてください。
④ 本当に動くか確かめる
設定して終わりにすると「入れたつもり」になります。実際に履歴を1つ作ってみます。
git init は「このフォルダの変更履歴を残し始める」という宣言です。こう出れば成功です。
Initialized empty Git repository in C:/Users/.../Desktop/git-test/.git/
.gitというフォルダが作られています。ここに履歴が全部入ります。 これを消すと履歴も消えます。
ファイルを1つ作って、記録してみます。
3つのコマンドは、それぞれこういう意味です。
| コマンド | やっていること | 例えるなら |
|---|---|---|
git add | 記録する対象を選ぶ | カゴに入れる |
git commit | 選んだものを履歴に確定する | レジを通す |
-m "..." | 「なぜ変えたか」のメモを付ける | レシートに書く |
add と commit が分かれているのが最初の分かりにくさでした。「変更したファイル全部ではなく、今回の記録に含めるものだけ選べる」ための2段階になっています。
履歴を見ます。
4ef305f メモを追加
これが「履歴が残った」状態です。 短い英数字はコミットIDで、この時点のファイル全体に付けられた通し番号のようなものです。
[スクリーンショット: 03_git_log.png] git log --oneline の結果が出た画面を撮ってください。
変更を検知するところまで見る
もう一歩だけ。ファイルを書き換えて、Gitが気づくか見ます。
Changes not staged for commit:
modified: memo.txt
modified(変更あり)と言われました。 Git がファイルの変化を見張っている、ということが分かります。
どこが変わったかも見られます。
実際の出力はこうでした。
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バイトを見ると、こうなっていました。
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で保存します。
確認できたら、練習用フォルダは消して構いません。
つまずいたところ
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 本目です。
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。
roadmap.sh のどこをやっているか
- Basic Usage of Git
- VCS Hosting — GitHub
この記事は、上の項目を実際に手を動かして確かめる回です。

コメント