第2章 Gitの設定と関連ファイル

Git は「インストールしたらすぐ使える」ツールですが、
設定ファイルをきちんと整えることで、チーム全体の開発効率が大きく変わります。

この章では、管理者として知っておくべき設定ファイルを順番に見ていきましょう ⚙️

この章のゴール

1. .gitconfig の3階層を理解し、チーム標準設定を設計できる
2. .gitignore を適切に設計できる
3. .gitattributes の役割を理解できる
4. Git Hooks で自動化の仕組みを作れる
5. エイリアスで日常操作を効率化できる

---

2.1 .gitconfig ─ Gitの設定ファイル

3つの階層

Git の設定には 3つの階層 があり、より狭い範囲の設定が優先されます。

flowchart TD
    S["🖥️ System
/etc/gitconfig
PC全体に適用"]
    G["👤 Global
~/.gitconfig
ユーザー全体に適用"]
    L["📁 Local
.git/config
リポジトリごとに適用"]

    S --> G --> L

    P["⬆️ 下にいくほど優先度が高い"]

    style S fill:#F3E5F5,stroke:#8E24AA,color:#4A148C
    style G fill:#E3F2FD,stroke:#1E88E5,color:#0D47A1
    style L fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    style P fill:#FFF9C4,stroke:#F9A825,color:#F57F17

階層	ファイルの場所	対象範囲	設定コマンド
System	/etc/gitconfig	PC 全体	git config --system
Global	~/.gitconfig	ユーザー全体	git config --global
Local	.git/config	リポジトリ単位	git config --local

最初にやるべき設定

# ユーザー名とメールアドレス（必須）
git config --global user.name "Taro Yamada"
git config --global user.email "taro@example.com"

# デフォルトブランチ名
git config --global init.defaultBranch main

# エディタの設定
git config --global core.editor "code --wait"    # VS Code
git config --global core.editor "vim"             # Vim

# 改行コードの自動変換
git config --global core.autocrlf input   # macOS / Linux
git config --global core.autocrlf true    # Windows

管理者向けおすすめ設定

# fetch 時に不要なリモートブランチを自動削除
git config --global fetch.prune true

# push 時に現在のブランチだけを送る（安全）
git config --global push.default current

# pull 時に rebase する（直線的な履歴を保つ）
git config --global pull.rebase true

# カラー表示を有効化
git config --global color.ui auto

# 日本語ファイル名を正しく表示
git config --global core.quotepath false

設定の確認と編集

# すべての設定を一覧表示（どの階層かも表示）
git config --list --show-origin

# 特定の設定を確認
git config user.name

# Global 設定ファイルをエディタで直接編集
git config --global --edit

チームで設定を共有するには？

Global 設定はあくまで各自の PC に保存されるため、
リポジトリ内の ドキュメントや README にチーム推奨設定を書いておくと良いでしょう。

また、.gitattributes や .gitignore はリポジトリに含められるので、
チーム全体で共有したい設定 はそちらに書くのがベストです。

---

2.2 .gitignore ─ 追跡しないファイルを指定

.gitignore とは？

.gitignore は、Git に 「このファイルは追跡しないで」 と伝える設定ファイルです。
リポジトリのルートに配置し、バージョン管理の対象から除外したいファイルを指定します。

なぜ必要なの？

追跡すべきでないファイルの例を見てみましょう。

ファイルの種類	例	理由
ビルド成果物	dist/, build/	再生成できる
依存パッケージ	node_modules/, vendor/	パッケージマネージャで復元できる
環境設定	.env, .env.local	機密情報を含む可能性
IDE 設定	.vscode/, .idea/	個人の環境に依存
OS 生成ファイル	.DS_Store, Thumbs.db	不要なノイズ
ログ・キャッシュ	*.log, .cache/	一時的なデータ

書き方の基本

.gitignore

# コメント
# ─────────────────────────────
# 特定のファイル
.env
.DS_Store

# 特定の拡張子
*.log
*.tmp

# 特定のディレクトリ（末尾にスラッシュ）
node_modules/
dist/
build/

# ワイルドカード
*.min.js
*.min.css

# 否定パターン（特定のファイルだけ追跡する）
!important.log

# ディレクトリの深さに関係なくマッチ
**/logs/
**/*.backup

パターンの早見表

パターン	マッチするもの	説明
*.log	error.log, debug.log	拡張子でマッチ
build/	build/ ディレクトリ全体	ディレクトリ指定
/TODO	ルート直下の TODO のみ	ルート限定
doc/*.txt	doc/notes.txt	1階層だけマッチ
doc/**/*.pdf	doc/a/b/c.pdf	全階層マッチ
!README.md	README.md を除外しない	否定パターン

プロジェクト別テンプレート

gitignore.io を活用しよう

gitignore.io を使うと、
プロジェクトの種類に応じた .gitignore を 自動生成 できます。

# コマンドラインからも生成可能
curl -sL https://www.toptal.com/developers/gitignore/api/node,react,macos > .gitignore

すでに追跡してしまったファイルを除外する

.gitignore に追加しただけでは、すでに追跡中のファイル は除外されません。
キャッシュをクリアする必要があります。

# 特定のファイルを追跡から外す
git rm --cached .env

# ディレクトリ全体を追跡から外す
git rm -r --cached node_modules/

# .gitignore 更新後に全体を再適用
git rm -r --cached .
git add .
git commit -m "chore: .gitignore を更新し追跡対象を修正"

git rm —cached の注意

このコマンドは Git の追跡から外す だけで、ファイル自体は削除されません。
ただし、他のメンバーが pull するとファイルが削除される場合があるので、
事前に チームに周知 してから実行しましょう。

---

2.3 .gitattributes ─ ファイル属性の管理

.gitattributes とは？

.gitattributes は、ファイルごとに Git の扱い方を指定する 設定ファイルです。
改行コードの統一、差分表示の方法、Git LFS の対象指定などに使います。

改行コードの統一

Windows（CRLF）と macOS/Linux（LF）が混在するチームでは特に重要です。

.gitattributes

# テキストファイルの改行コードを自動正規化
* text=auto

# 特定の拡張子を明示的に指定
*.js    text eol=lf
*.ts    text eol=lf
*.json  text eol=lf
*.md    text eol=lf
*.yml   text eol=lf
*.sh    text eol=lf

# バイナリファイルとして扱う（差分を取らない）
*.png   binary
*.jpg   binary
*.gif   binary
*.ico   binary
*.woff2 binary

設定	意味
text=auto	Git が自動判定してテキストファイルの改行を正規化
text eol=lf	チェックアウト時に LF に統一
text eol=crlf	チェックアウト時に CRLF に統一
binary	バイナリとして扱う（改行変換・差分表示しない）

diff の表示方法をカスタマイズ

.gitattributes

# ロックファイルの差分を非表示
package-lock.json -diff
yarn.lock -diff

# 画像の差分を exif で表示（要設定）
*.png diff=exif

Git LFS の指定

大容量ファイルを扱う場合（第3章で詳しく解説）。

.gitattributes

*.psd   filter=lfs diff=lfs merge=lfs -text
*.ai    filter=lfs diff=lfs merge=lfs -text
*.mp4   filter=lfs diff=lfs merge=lfs -text

.gitattributes はリポジトリに含めよう

.gitconfig と違い、.gitattributes は リポジトリに含めてコミットできます。
つまり、チーム全員に同じ設定が自動で適用されます。

新規リポジトリを作ったら、最初にこのファイルを整備しましょう。

---

2.4 .git/hooks ─ ローカル自動化

Git Hooks とは？

Git Hooks は、特定のイベント（コミット、プッシュなど）が発生したときに
自動でスクリプトを実行する 仕組みです。

flowchart LR
    A["git commit 実行"] --> B["pre-commit
フック発火 🔥"]
    B -- "成功 ✅" --> C["コミット完了"]
    B -- "失敗 ❌" --> D["コミット中止"]

    style A fill:#E3F2FD,stroke:#1E88E5,color:#0D47A1
    style B fill:#FFF9C4,stroke:#F9A825,color:#F57F17
    style C fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    style D fill:#FFEBEE,stroke:#E53935,color:#B71C1C

よく使う Hooks

フック名	タイミング	使用例
pre-commit	コミット前	リンター実行、フォーマットチェック
commit-msg	コミットメッセージ入力後	メッセージ形式のチェック
pre-push	プッシュ前	テスト実行
post-merge	マージ後	依存パッケージの自動インストール
prepare-commit-msg	メッセージ編集前	テンプレートの自動挿入

実践例：pre-commit でリンターを実行

.git/hooks/pre-commit

#!/bin/sh
echo "🔍 コミット前チェックを実行中..."

# JavaScript/TypeScript のリント
npx eslint --quiet .
if [ $? -ne 0 ]; then
    echo "❌ ESLint エラーがあります。修正してからコミットしてください。"
    exit 1
fi

echo "✅ チェック通過！"
exit 0

# 実行権限を付与（忘れがち！）
chmod +x .git/hooks/pre-commit

実践例：commit-msg でメッセージ形式をチェック

.git/hooks/commit-msg

#!/bin/sh
MSG=$(cat "$1")
PATTERN="^(feat|fix|docs|style|refactor|test|chore|perf|ci)(\(.+\))?: .+"

if ! echo "$MSG" | grep -qE "$PATTERN"; then
    echo "❌ コミットメッセージが Conventional Commits 形式ではありません。"
    echo "   例: feat(auth): ログイン機能を追加"
    echo "   例: fix: ヘッダーの表示崩れを修正"
    exit 1
fi

exit 0

.git/hooks はバージョン管理されない

.git/ ディレクトリはバージョン管理の対象外です。
つまり、Hooks を直接 .git/hooks/ に置いてもチームで共有されません。

解決策として Husky や lefthook などのツールを使うのが一般的です。

Husky を使ったチーム共有

# Husky のインストール
npm install --save-dev husky

# Husky の初期化
npx husky init

# pre-commit フックを設定
echo "npx lint-staged" > .husky/pre-commit

.husky/ ディレクトリはリポジトリに含められるため、
チーム全員に同じ Hooks が自動適用 されます。

---

2.5 Git Aliases ─ コマンドの効率化

よく使うエイリアス

毎回長いコマンドを打つのは非効率です。
エイリアスで日常操作をスピードアップしましょう。

# ──── 基本操作 ────
git config --global alias.st "status"
git config --global alias.co "checkout"
git config --global alias.br "branch"
git config --global alias.ci "commit"

# ──── ログ表示 ────
git config --global alias.lg "log --oneline --graph --all"
git config --global alias.ll "log --oneline -15"
git config --global alias.last "log -1 HEAD --stat"

# ──── 差分確認 ────
git config --global alias.df "diff"
git config --global alias.ds "diff --staged"

# ──── 便利系 ────
git config --global alias.unstage "restore --staged"
git config --global alias.undo "reset --soft HEAD~1"
git config --global alias.amend "commit --amend --no-edit"

使用例

# 設定前
git log --oneline --graph --all

# 設定後
git lg

チーム推奨エイリアス集を作ろう

README や Wiki に チーム推奨エイリアス をまとめておくと、
新メンバーのオンボーディングがスムーズになります。

セットアップスクリプトを用意するのもおすすめです ✨

setup-aliases.sh

#!/bin/sh
echo "🔧 Git エイリアスを設定中..."
git config --global alias.st "status"
git config --global alias.co "checkout"
git config --global alias.lg "log --oneline --graph --all"
git config --global alias.undo "reset --soft HEAD~1"
echo "✅ 完了！"

---

まとめ

ファイル / 設定	場所	バージョン管理	主な用途
.gitconfig	~/.gitconfig	❌	ユーザー個人の設定
.gitignore	リポジトリルート	✅	追跡除外ファイルの指定
.gitattributes	リポジトリルート	✅	改行コード統一、LFS 指定
.git/hooks/	.git/hooks/	❌	ローカル自動化
.husky/	リポジトリルート	✅	Hooks のチーム共有
Git Aliases	.gitconfig 内	❌	コマンドのショートカット

達成チェック ✅

• .gitconfig の3階層（system / global / local）を理解している
• .gitignore のパターン記法を使いこなせる
• .gitattributes で改行コードを統一できる
• Git Hooks の仕組みと Husky によるチーム共有を理解している
• エイリアスで日常操作を効率化できる

次は 第3章「Gitの高度な機能」 に進みましょう！ 🎉