「Gitをインストールしようとしたけど、エラーが出て進めない…」
「インストールは完了したはずなのに、gitコマンドが使えない…」
「管理者権限がなくて、インストールできない…」
プログラミングの勉強を始めたり、GitHubを使おうとしたりする時、最初の壁となるのがGitのインストールです。
この記事では、Gitのインストールで発生する様々な問題と、その解決方法をOS別に詳しく解説していきます。初心者の方でも、順番に読んでいけば必ず解決できるようになっていますよ!
1. インストール前の確認事項

トラブルを避けるため、まず以下を確認しましょう。
確認項目1:OSとバージョン
Windows の場合:
- スタートボタンを右クリック
- 「システム」を選択
- Windowsのバージョンと、32bit/64bitを確認
対応バージョン:
- Windows 7以降(Windows 11含む)
- 32bit版と64bit版の両方に対応
- Windows Vista: Git 2.37.1まで
- Windows XP: Git 2.10.0まで
Mac の場合:
- 画面左上の マークをクリック
- 「このMacについて」を選択
- macOSのバージョンを確認
対応バージョン:
- macOS 10.9 (Mavericks) 以降
Linux の場合:
ターミナルで以下を実行:
cat /etc/os-release
確認項目2:既存のGitの有無
既にGitがインストールされているか確認しましょう。
確認方法:
ターミナル(Mac/Linux)またはコマンドプロンプト(Windows)で:
git --version
結果:
- バージョンが表示される → 既にインストール済み
- 「コマンドが見つかりません」などのエラー → 未インストール
既にインストール済みの場合は、「4章:コマンドが使えない問題」を参照してください。
確認項目3:管理者権限の有無
Windows の場合:
- コマンドプロンプトを右クリック
- 「管理者として実行」が選択できる → 管理者権限あり
Mac/Linux の場合:
ターミナルで:
sudo echo "test"
パスワード入力後に「test」と表示される → 管理者権限あり
権限がない場合:
7章「管理者権限がない環境でのインストール」を参照してください。
確認項目4:ディスクの空き容量
必要な容量:
- 最低限:500MB
- 推奨:1GB以上
確認方法:
Windows:
- エクスプローラーで「PC」を開く
- Cドライブの空き容量を確認
Mac:
- 画面左上の マーク
- 「このMacについて」→「ストレージ」
Linux:
df -h
2. OS別の正しいインストール方法
まず、各OSでの正しいインストール方法を確認しましょう。
Windows の正しいインストール方法
ステップ1:公式サイトからダウンロード
- https://git-scm.com/download/win にアクセス
- 自動でOSに合ったバージョンがダウンロード開始
- または「64-bit Git for Windows Setup」を手動でクリック
ステップ2:インストーラーの実行
- ダウンロードした「Git-x.xx.x-64-bit.exe」をダブルクリック
- 「このアプリがデバイスに変更を加えることを許可しますか?」→「はい」
ステップ3:インストール設定(重要)
以下の設定画面で、推奨設定を選択してください:
① インストール先:
- デフォルト(C:\Program Files\Git)のまま「Next」
② コンポーネント:
- 「Additional icons」:お好みで
- 「Windows Explorer integration」:チェック推奨
- 「Git Bash Here」:チェック推奨
- 「Git GUI Here」:お好みで
- 「Git LFS」:チェック推奨
- 「Associate .git* … with the default text editor」:チェック推奨
③ デフォルトエディタ:
- 初心者は「Use Nano editor」または「Use Notepad」推奨
④ PATH設定(最重要):
- 「Git from the command line and also from 3rd-party software」を選択
- これが最も重要な設定です!
⑤ HTTPSライブラリ:
- 「Use the OpenSSL library」を選択(デフォルト)
⑥ 改行コード:
- 「Checkout Windows-style, commit Unix-style line endings」を選択
- これがWindowsの推奨設定です
⑦ ターミナル:
- 「Use MinTTY」を選択(デフォルト)
⑧ git pull の動作:
- 「Default (fast-forward or merge)」を選択
⑨ Credential Helper:
- 「Git Credential Manager」を選択
⑩ その他のオプション:
- 「Enable file system caching」:チェック
- 「Enable symbolic links」:お好みで
ステップ4:インストール完了
「Finish」をクリックして完了
ステップ5:動作確認
- スタートメニューから「Git Bash」を起動
- 以下を入力:
git --version
- バージョンが表示されれば成功
Mac の正しいインストール方法
Macには3つのインストール方法があります。
方法1:Xcode Command Line Tools(最も簡単)
ステップ1:インストール
ターミナルで以下を実行:
xcode-select --install
ステップ2:確認
インストール確認画面が表示されるので「インストール」をクリック
ステップ3:動作確認
インストール完了後:
git --version
方法2:Homebrew経由(推奨)
Homebrewがインストールされている場合:
brew install git
動作確認:
git --version
方法3:公式インストーラー
- https://git-scm.com/download/mac にアクセス
- インストーラー(.dmg)をダウンロード
- ダウンロードしたファイルを開く
- 指示に従ってインストール
Linux の正しいインストール方法
ディストリビューションごとに異なります。
Ubuntu / Debian
sudo apt-get update
sudo apt-get install git
Fedora / CentOS / RHEL
Fedora:
sudo dnf install git
CentOS / RHEL:
sudo yum install git
Arch Linux
sudo pacman -S git
動作確認:
git --version
3. Windows編:インストールできない・gitコマンドが効かない
Windowsでの最も多い問題と解決方法です。
問題1:「git: command not found」またはPATHエラー
症状:
'git' は、内部コマンドまたは外部コマンド、
操作可能なプログラムまたはバッチ ファイルとして認識されていません。
原因:
Gitのインストール場所が環境変数PATHに登録されていない
解決方法:
ステップ1:Gitのインストール場所を確認
- エクスプローラーで
C:\Program Files\Gitを開く cmdフォルダとbinフォルダを確認- アドレスバーをクリックして、パスをコピー
通常は以下のパス:
C:\Program Files\Git\cmdC:\Program Files\Git\bin
ステップ2:環境変数にパスを追加
- スタートボタンを右クリック
- 「システム」を選択
- 右側の「システムの詳細設定」をクリック
- 「環境変数」ボタンをクリック
または:
- Windowsキーを押す
- 「環境変数」と入力
- 「システム環境変数の編集」をクリック
- 「環境変数」ボタンをクリック
ステップ3:Pathを編集
- 「システム環境変数」の一覧から「Path」を選択
- 「編集」ボタンをクリック
- 「新規」ボタンをクリック
C:\Program Files\Git\cmdを入力- もう一度「新規」をクリック
C:\Program Files\Git\binを入力- 「OK」を3回クリックしてすべてのウィンドウを閉じる
ステップ4:再起動と確認
- 開いているコマンドプロンプトやPowerShellをすべて閉じる
- 新しくコマンドプロンプトを開く
git --versionを実行- バージョンが表示されれば成功
注意点:
- 古いコマンドプロンプトでは反映されません
- 必ず新しく開き直してください
- PCの再起動が必要な場合もあります
問題2:管理者権限エラー
症状:
このアプリがデバイスに変更を加えることを許可しますか?
→ 「いいえ」しか選べない、または権限エラー
原因:
管理者権限がない、またはユーザーアカウント制御(UAC)の設定
解決方法:
方法A:管理者として実行
- インストーラーを右クリック
- 「管理者として実行」を選択
方法B:管理者にインストールを依頼
学校や会社のPCの場合、IT管理者に依頼が必要な場合があります。
方法C:ポータブル版を使用
管理者権限が得られない場合は、7章を参照してください。
問題3:インストーラーがフリーズする
症状:
インストール中に進行が止まる、応答なしになる
原因:
- ウイルス対策ソフトがスキャン中
- 他のプログラムが干渉
- ディスク容量不足
- 破損したインストーラー
解決方法:
ステップ1:ウイルス対策ソフトを一時的に無効化
- システムトレイのウイルス対策ソフトアイコンを右クリック
- 一時的に無効化(10分程度)
- インストールを再試行
- インストール後、必ず有効に戻す
ステップ2:クリーンブート
- スタートメニューで「msconfig」と検索
- 「システム構成」を開く
- 「サービス」タブ
- 「Microsoftのサービスをすべて隠す」にチェック
- 「すべて無効」をクリック
- PCを再起動
- インストールを試行
ステップ3:インストーラーを再ダウンロード
- 既存のインストーラーを削除
- 公式サイトから再ダウンロード
- ダウンロード完了を確認してから実行
問題4:「.NET Framework」エラー
症状:
.NET Framework 4.5.1以降が必要です
原因:
Git Credential Managerに必要な.NET Frameworkがインストールされていない
解決方法:
方法A:.NET Frameworkをインストール
- https://dotnet.microsoft.com/download/dotnet-framework にアクセス
- .NET Framework 4.8(最新版)をダウンロード
- インストール
- PCを再起動
- Gitのインストールを再試行
方法B:Credential Manager を無効化してインストール
- Gitインストーラーを起動
- 「Enable Git Credential Manager」のチェックを外す
- インストール続行
問題5:Windows Defenderのブロック
症状:
インストール中に「このアプリは保護されました」と表示される
解決方法:
ステップ1:詳細情報を表示
- 「詳細情報」をクリック
- 「実行」ボタンが表示される
- 「実行」をクリック
ステップ2:それでもブロックされる場合
- 「Windowsセキュリティ」を開く
- 「ウイルスと脅威の防止」
- 「設定の管理」
- 一時的に「リアルタイム保護」をオフ
- インストール
- インストール後、必ずオンに戻す
ステップ3:除外設定
- 「Windowsセキュリティ」を開く
- 「ウイルスと脅威の防止」
- 「設定の管理」
- 「除外」→「除外の追加または削除」
- 「フォルダー」を選択
C:\Program Files\Gitを追加
問題6:日本語が文字化けする
症状:
Git Bashで日本語ファイル名が文字化けする
解決方法:
Git Bashで以下を実行:
git config --global core.quotepath false
Git Bashのエンコーディング設定:
- Git Bashのウィンドウを右クリック
- 「Options…」を選択
- 「Text」→「Locale」を「ja_JP」に
- 「Character set」を「UTF-8」に
- 「Apply」→「Save」
4. Mac編:インストール失敗・権限エラー

問題1:「Permission denied」エラー
症状:
Permission denied
Failed during: git init -q
原因:
- /usr/local の権限設定
- Homebrewの権限問題
- Xcodeの署名期限切れ
解決方法:
方法A:/usr/local の権限を修正
sudo chown -R $(whoami) /usr/local
パスワードを入力後、再度インストールを試行
方法B:Homebrewを再インストール
# Homebrewをアンインストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
# Homebrewを再インストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Gitをインストール
brew install git
方法C:Xcodeを更新
sudo rm -rf /Library/Developer/CommandLineTools
xcode-select --install
問題2:「xcrun: error」
症状:
xcrun: error: invalid active developer path
xcrun: error: unable to find utility "git"
原因:
Xcodeまたは Command Line Toolsが正しくインストールされていない
解決方法:
xcode-select --install
表示される確認画面で「インストール」をクリック
それでも解決しない場合:
sudo xcode-select --reset
xcode-select --install
問題3:Homebrewのインストールに失敗
症状:
Homebrew自体がインストールできない
解決方法:
ステップ1:既存のHomebrewを削除
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"
ステップ2:/usr/local を削除して再作成
sudo rm -rf /usr/local/Homebrew
sudo mkdir -p /usr/local/Homebrew
sudo chown -R $(whoami):admin /usr/local/Homebrew
ステップ3:Homebrewを再インストール
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
ステップ4:Gitをインストール
brew install git
問題4:「chflags」ファイル保護エラー
症状:
Operation not permitted
chflags: <file>: Operation not permitted
原因:
macOSのファイル保護機能
解決方法:
# immutableフラグを削除
sudo chflags -R nouchg /usr/local/Homebrew
# 再度インストール
brew install git
問題5:M1/M2 Mac での PATH問題
症状:
インストールは成功するが、gitコマンドが見つからない
原因:
Apple Silicon MacでのHomebrew PATH設定
解決方法:
ステップ1:PATHを確認
echo $PATH
ステップ2:~/.zshrc を編集
nano ~/.zshrc
以下を追加:
# Homebrew PATH for Apple Silicon
eval "$(/opt/homebrew/bin/brew shellenv)"
ステップ3:設定を反映
source ~/.zshrc
ステップ4:確認
git --version
問題6:macOSのバージョンが古い
症状:
macOS 10.8以前でインストールできない
解決方法:
方法A:macOSをアップデート
可能であれば、最新のmacOSにアップデートする
方法B:古いバージョンのGitをインストール
- https://sourceforge.net/projects/git-osx-installer/ にアクセス
- 古いバージョンをダウンロード
- インストール
5. Linux編:インストールエラー・依存関係の問題
問題1:「E: Unable to locate package git」
症状(Ubuntu/Debian):
E: Unable to locate package git
原因:
パッケージリストが古い
解決方法:
# パッケージリストを更新
sudo apt-get update
# Gitをインストール
sudo apt-get install git
それでも解決しない場合:
# リポジトリを修正
sudo apt-get install software-properties-common
sudo add-apt-repository ppa:git-core/ppa
sudo apt-get update
sudo apt-get install git
問題2:依存関係エラー
症状:
The following packages have unmet dependencies:
git : Depends: liberror-perl but it is not installable
解決方法:
ステップ1:壊れた依存関係を修正
sudo apt-get install -f
ステップ2:再度インストール
sudo apt-get install git
それでも解決しない場合:
# 完全にクリーンアップ
sudo apt-get clean
sudo apt-get autoremove
sudo apt-get update
sudo apt-get install git
問題3:権限エラー
症状:
Permission denied
解決方法:
ステップ1:sudoを使用
sudo apt-get install git
ステップ2:sudoが使えない場合
システム管理者に依頼、または後述のソースからビルド方法を参照
問題4:古いバージョンがインストールされる
症状:
インストールはできるが、バージョンが古すぎる
解決方法(Ubuntu/Debian):
# PPAリポジトリを追加
sudo add-apt-repository ppa:git-core/ppa
sudo apt-get update
sudo apt-get install git
解決方法(Fedora):
# 最新リポジトリを有効化
sudo dnf copr enable elrepo/elrepo
sudo dnf install git
問題5:ソースからのビルド失敗
症状:
ソースコードからビルドしようとしてエラー
解決方法:
ステップ1:必要な依存パッケージをインストール
Ubuntu/Debian:
sudo apt-get install build-essential libssl-dev libcurl4-gnutls-dev \
libexpat1-dev gettext unzip
Fedora/CentOS:
sudo dnf install gcc make openssl-devel curl-devel expat-devel \
gettext-devel perl-devel zlib-devel
ステップ2:ソースをダウンロード
cd /tmp
wget https://github.com/git/git/archive/refs/tags/v2.43.0.tar.gz
tar -xzf v2.43.0.tar.gz
cd git-2.43.0
ステップ3:ビルドとインストール
make prefix=/usr/local all
sudo make prefix=/usr/local install
問題6:「git-core」パッケージとの競合
症状:
git-core と git のパッケージが競合
解決方法:
# 古いパッケージを削除
sudo apt-get remove git-core
# Gitをインストール
sudo apt-get install git
6. 共通問題:インストールは成功したのにコマンドが使えない

OSに関係なく発生する問題です。
問題1:新しいターミナルで試していない
症状:
インストール後も「command not found」
原因:
古いターミナルセッションでは環境変数が更新されていない
解決方法:
- すべてのターミナル/コマンドプロンプトを閉じる
- 新しく開く
git --versionを実行
問題2:PATHが通っていない
症状:
再起動しても「command not found」
解決方法:
Windows:
3章の「問題1:PATHエラー」を参照
Mac:
# ~/.zshrc または ~/.bash_profile に追加
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Linux:
# ~/.bashrc に追加
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
問題3:エイリアスの競合
症状:
gitコマンドが別のプログラムを起動する
原因:
既存のエイリアスやスクリプト
解決方法:
確認:
which git
type git
alias git
エイリアスを削除:
unalias git
恒久的に修正(Mac/Linux):
~/.zshrc または ~/.bashrc を編集してエイリアス定義を削除
問題4:複数バージョンの競合
症状:
異なるバージョンが表示される
解決方法:
確認:
# すべてのgitの場所を表示
# Windows (PowerShell)
Get-Command git -All
# Mac/Linux
which -a git
不要なバージョンを削除:
Windows:
- 古いインストールをコントロールパネルからアンインストール
- PATH から不要なパスを削除
Mac:
# Homebrew版以外を削除する場合
sudo rm /usr/bin/git
Linux:
# パッケージマネージャーからアンインストール
sudo apt-get remove git
# またはソースビルド版を削除
sudo rm /usr/local/bin/git
7. 管理者権限がない環境でのインストール
学校や会社のPCなど、管理者権限がない場合の方法です。
Windows:ポータブル版Git
特徴:
- 管理者権限不要
- USBメモリにも保存可能
- 設定を持ち運べる
インストール手順:
ステップ1:ダウンロード
- https://git-scm.com/download/win にアクセス
- 「Portable (“thumbdrive edition”)」を選択
- 64-bitまたは32-bitを選択してダウンロード
ステップ2:解凍
- ダウンロードした
.7z.exeファイルを実行 - 解凍先を選択(例:
D:\PortableApps\Git) - ユーザーフォルダまたは外部ドライブを推奨
- 「OK」をクリック
ステップ3:初期化
解凍後、post-install.bat が自動実行されます。
手動で実行する必要がある場合は、そのファイルをダブルクリック。
ステップ4:動作確認
解凍先フォルダで git-bash.exe を実行:
git --version
ステップ5:PATH設定(オプション)
他のプログラムからGitを使う場合:
- Windowsキー + Pause キー
- 「システムの詳細設定」
- 「環境変数」
- 「ユーザー環境変数」の「Path」を編集(システム環境変数ではない)
- 「新規」をクリック
D:\PortableApps\Git\binを追加(実際のパスに合わせる)- 「OK」
注意点:
- システム環境変数ではなく、ユーザー環境変数を編集
- 管理者権限は不要
Mac:Homebrewをユーザーディレクトリに
手順:
# ホームディレクトリにHomebrewをインストール
mkdir ~/homebrew && curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C ~/homebrew
# PATHを設定
echo 'export PATH="$HOME/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# Gitをインストール
brew install git
Linux:ホームディレクトリにインストール
手順:
ステップ1:ソースをダウンロード
cd ~
wget https://github.com/git/git/archive/refs/tags/v2.43.0.tar.gz
tar -xzf v2.43.0.tar.gz
cd git-2.43.0
ステップ2:ビルド
# ホームディレクトリにインストール
make prefix=$HOME/git all
make prefix=$HOME/git install
ステップ3:PATH設定
echo 'export PATH="$HOME/git/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
ステップ4:確認
git --version
8. 企業ネットワーク・ファイアウォール環境での対処法
問題1:プロキシエラー
症状:
Failed to connect to github.com port 443: Connection timed out
原因:
企業プロキシの設定が必要
解決方法:
ステップ1:プロキシ情報を確認
IT部門に以下を確認:
- プロキシサーバーのアドレス
- ポート番号
- 認証の有無(ユーザー名/パスワード)
ステップ2:Gitにプロキシを設定
認証なしの場合:
git config --global http.proxy http://proxy.example.com:8080
git config --global https.proxy https://proxy.example.com:8080
認証ありの場合:
git config --global http.proxy http://username:password@proxy.example.com:8080
git config --global https.proxy https://username:password@proxy.example.com:8080
パスワードに特殊文字が含まれる場合:
URLエンコードが必要(例:@ → %40)
ステップ3:SSL証明書検証の設定
自己署名証明書を使用している場合:
# 証明書検証を無効化(セキュリティリスクあり、社内のみ推奨)
git config --global http.sslVerify false
問題2:ファイアウォールでブロック
症状:
特定のサイトにアクセスできない
解決方法:
方法A:HTTPSポート443を使用
# SSHの代わりにHTTPSを使用
git clone https://github.com/username/repo.git
方法B:IT部門に許可を依頼
以下のドメインへのアクセス許可を依頼:
- github.com
- git-scm.com
- githubusercontent.com
問題3:SSL証明書エラー
症状:
SSL certificate problem: unable to get local issuer certificate
原因:
企業の自己署名証明書
解決方法:
方法A:証明書をインポート
# 証明書ファイルのパスを指定
git config --global http.sslCAInfo /path/to/certificate.crt
方法B:検証を一時的に無効化
git config --global http.sslVerify false
注意:
この設定はセキュリティリスクがあるため、信頼できるネットワークでのみ使用してください。
問題4:ダウンロード速度が遅い
症状:
インストールやクローンに異常に時間がかかる
解決方法:
方法A:プロキシキャッシュを活用
IT部門に確認してプロキシキャッシュを設定
方法B:タイムアウトを延長
git config --global http.postBuffer 524288000
git config --global http.lowSpeedLimit 0
git config --global http.lowSpeedTime 999999
よくある質問(FAQ)
Q1: Gitは無料ですか?ライセンスは必要ですか?
回答: Git は完全に無料です。
- ライセンス: GNU General Public License version 2(GPL v2)
- 商用利用: 可能
- 費用: 無料
- 制限: なし
インストール時に表示される「GPL License」の確認は、ライセンスへの同意を求めているだけで、費用は発生しません。
Q2: 32bit版と64bit版、どちらをインストールすべきですか?
回答: 基本的に64bit版を選択してください。
確認方法(Windows):
- スタートボタンを右クリック
- 「システム」を選択
- 「システムの種類」を確認
目安:
- 2010年以降のPC → ほぼ100% 64bit
- メモリ4GB以上 → 64bit
- 不明な場合 → 64bit版を試す(エラーが出たら32bit版)
Q3: 複数のバージョンをインストールできますか?
回答: 技術的には可能ですが、推奨しません。
理由:
- PATH設定が複雑になる
- どのバージョンが実行されるか混乱する
- トラブルの原因になる
推奨:
- 1つのバージョンのみインストール
- プロジェクトごとに異なるバージョンが必要な場合はDockerを検討
Q4: アンインストール方法は?
Windows:
- 「設定」→「アプリ」
- 「Git」を検索
- 「アンインストール」
Mac(Homebrew):
brew uninstall git
Mac(手動インストール):
sudo rm -rf /usr/local/git
sudo rm /etc/paths.d/git
Linux:
# Ubuntu/Debian
sudo apt-get remove git
# Fedora
sudo dnf remove git
Q5: Gitのアップデート方法は?
Windows:
新しいインストーラーをダウンロードして実行
- 既存の設定は保持されます
Mac(Homebrew):
brew update
brew upgrade git
Linux:
# Ubuntu/Debian
sudo apt-get update
sudo apt-get upgrade git
# Fedora
sudo dnf upgrade git
Q6: VirusTotal で脅威と検出されました。安全ですか?
回答: 公式サイトからダウンロードすれば安全です。
確認方法:
- 正しいURL: https://git-scm.com/
- 避けるべき: 検索結果の広告、非公式サイト
誤検出の理由:
- Gitは実行ファイルを含むため、一部のウイルス対策ソフトが過剰反応
- 特にポータブル版は誤検出されやすい
対処法:
- Windows Defender SmartScreenで「詳細情報」から実行
- ウイルス対策ソフトの除外リストに追加
Q7: Git Bash と Git CMD、どちらを使うべきですか?
回答: 初心者は Git Bash を推奨します。
Git Bash:
- Unix系コマンドが使える
- チュートリアルの大半がBash前提
- 色分け表示で見やすい
- 推奨
Git CMD:
- Windowsコマンドプロンプトそのまま
- Windows固有のコマンドも使える
- Windowsに慣れている人向け
PowerShell:
- より強力
- スクリプト作成に向いている
- 上級者向け
Q8: インストール後、最初に設定すべきことは?
回答: ユーザー名とメールアドレスの設定です。
設定方法:
# ユーザー名を設定
git config --global user.name "あなたの名前"
# メールアドレスを設定
git config --global user.email "your.email@example.com"
確認方法:
git config --global user.name
git config --global user.email
重要性:
これらの情報はコミット履歴に記録されます。
特にGitHubを使う場合、GitHubのメールアドレスと同じにすることを推奨します。
Q9: SSH接続とHTTPS接続、どちらがいいですか?
回答: 初心者はHTTPSを推奨します。
HTTPS:
- 設定が簡単
- ファイアウォールを通りやすい
- パスワードまたはトークンで認証
- 初心者向け
SSH:
- 鍵の設定が必要
- パスワード入力不要(設定後)
- より安全
- 上級者向け
Q10: 「You appear to have cloned an empty repository」と表示されます
回答: これはエラーではありません。
意味:
クローンしたリポジトリがまだ空(コミットが1つもない)の状態です。
対処法:
- ファイルを追加
- コミット
- プッシュ
echo "# My Project" >> README.md
git add README.md
git commit -m "first commit"
git push origin main
トラブルシューティングのチェックリスト

問題が解決しない場合、以下を順番に確認してください。
チェック1:基本事項
□ 公式サイトからダウンロードしたか
□ インストーラーが完全にダウンロードされたか
□ OSのバージョンは対応しているか
□ ディスクの空き容量は十分か(1GB以上推奨)
□ すべてのターミナル/コマンドプロンプトを閉じて再度開いたか
□ PCを再起動したか
チェック2:インストール設定
□ PATH設定を正しく選択したか(Windows)
□ 管理者権限で実行したか(Windows)
□ ウイルス対策ソフトを一時的に無効化したか
□ インストール先を変更していないか
チェック3:環境変数
□ PATH に Gitのパスが含まれているか
□ 複数のGitがインストールされていないか
□ エイリアスが設定されていないか
チェック4:その他
□ プロキシ設定が必要か(企業環境)
□ ファイアウォールがブロックしていないか
□ .NET Framework がインストールされているか(Windows)
□ Xcode Command Line Tools がインストールされているか(Mac)
それでも解決しない場合
方法1:ログを確認
Windows:
インストールログを確認:
C:\Users\<ユーザー名>\AppData\Local\Temp\- 最新の
Git-*.logファイル
エラーメッセージをコピーして検索
方法2:クリーンインストール
ステップ1:完全アンインストール
Windows:
- Git をアンインストール
C:\Program Files\Gitフォルダを手動削除C:\Users\<ユーザー名>\.gitconfigを削除- 環境変数から Git のパスを削除
- PCを再起動
Mac:
# Homebrew版
brew uninstall --force git
rm -rf /usr/local/Cellar/git
# 手動インストール版
sudo rm -rf /usr/local/git
sudo rm /etc/paths.d/git
Linux:
sudo apt-get purge git
sudo apt-get autoremove
sudo apt-get clean
ステップ2:再インストール
最初から手順をやり直す
方法3:代替方法
GitHub Desktop:
- Gitの機能を含むGUIアプリ
- インストールが簡単
- 初心者向け
- https://desktop.github.com/
Sourcetree:
- GUIベースのGitクライアント
- Gitを自動インストール
- https://www.sourcetreeapp.com/
方法4:コミュニティに質問
Stack Overflow:
- https://stackoverflow.com/
- タグ:
git,installation - エラーメッセージを正確に記載
GitHub Community:
- https://github.community/
- インストール関連のカテゴリ
質問時に含めるべき情報:
- OS とバージョン
- 試した解決方法
- エラーメッセージの全文
git --versionの結果(実行できる場合)- 環境変数 PATH の内容
まとめ
Gitのインストールで最も重要なポイントをまとめます。
Windows の場合
最重要:
- PATH設定を「Git from the command line and also from 3rd-party software」に
- 管理者権限で実行
- 環境変数を設定後、必ず新しいターミナルを開く
よくある問題:
- PATH が通っていない → 環境変数を手動で設定
- 管理者権限がない → ポータブル版を使用
- ウイルス対策ソフトがブロック → 一時的に無効化
Mac の場合
最重要:
- Xcode Command Line Tools を先にインストール
- Homebrew経由が最も簡単
- /usr/local の権限に注意
よくある問題:
- Permission denied → sudo chown で権限修正
- xcrun error → Xcode Command Line Tools 再インストール
- M1/M2 Mac → PATH設定を ~/.zshrc に追加
Linux の場合
最重要:
- パッケージマネージャーで最新版をインストール
- sudo 権限が必要
- 依存関係に注意
よくある問題:
- パッケージが見つからない → apt-get update
- 依存関係エラー → apt-get install -f
- 古いバージョン → PPAリポジトリを追加
共通のポイント
必ず確認:
- 公式サイトからダウンロード
- インストール後は新しいターミナルを開く
git --versionで動作確認- ユーザー名とメールアドレスを設定
避けるべき:
- 検索結果の広告からダウンロード
- 古いターミナルで確認
- 複数バージョンのインストール
- システムファイルの不用意な削除
次のステップ
Gitがインストールできたら、以下を設定しましょう:
# ユーザー情報の設定
git config --global user.name "あなたの名前"
git config --global user.email "your.email@example.com"
# エディタの設定(お好みで)
git config --global core.editor "nano"
# 改行コードの設定(Mac/Linux)
git config --global core.autocrlf input
# 日本語ファイル名の文字化け防止
git config --global core.quotepath false
# 設定の確認
git config --list
学習リソース:
- 公式ドキュメント:https://git-scm.com/doc
- Pro Git(日本語版):https://git-scm.com/book/ja/v2
- GitHub Learning Lab:https://lab.github.com/
これで、Gitのインストールに関するトラブルのほとんどは解決できるはずです。
もし、この記事の方法で解決しない場合は、コミュニティフォーラムやStack Overflowで質問してみてください。その際は、エラーメッセージ、OS情報、試した解決方法を詳しく書くと、的確な回答が得られやすくなります。
楽しいGitライフを!


コメント