測驗:Git 安裝與初次設定
共 5 題,點選答案後會立即顯示結果
1. 為什麼安裝 Git 後需要設定 user.name 和 user.email?
2. 以下哪個指令可以驗證 Git 是否安裝成功?
3. Git 設定的三個層級中,哪個優先順序最高?
4. 執行 git config --global user.name "小明" 後,這個設定會存放在哪裡?
5. 在 macOS 上安裝 Git 最簡單的方式是什麼?
一句話說明
安裝 Git 並做好基本設定,讓電腦知道「是誰」在做版本控制。
這篇文章會教你
讀完本篇後,你能夠:
- 在自己的作業系統上安裝 Git
- 完成必要的初次設定(user.name、user.email)
- 驗證 Git 安裝成功
- 了解 Git 設定的三個層級
為什麼要設定 user.name 和 email?
Git 會記錄「誰」做了「什麼修改」。每次提交(commit)都會附上作者資訊:
commit abc1234
Author: 小明 <ming@example.com>
Date: Mon Jan 20 10:30:00 2025
修復登入功能的 bug
Code language: CSS (css)如果沒有設定,Git 會拒絕讓你提交,或是用系統預設值(可能是電腦名稱,看起來很奇怪)。
各作業系統的安裝方式
Windows:Git for Windows
下載安裝:
- 前往 git-scm.com
- 下載安裝程式
- 執行安裝,大部分選項用預設即可
安裝重點:
安裝過程中會問很多選項,以下是新手建議:
| 設定項目 | 建議選擇 |
|---|---|
| 預設編輯器 | 選你慣用的(VS Code 推薦) |
| PATH 環境 | 選「Git from the command line and also from 3rd-party software」 |
| 換行符號 | 選「Checkout Windows-style, commit Unix-style line endings」 |
其他選項用預設值即可。
安裝完成後:
打開「Git Bash」或「命令提示字元」,輸入:
git --version
看到版本號就代表安裝成功:
git version 2.43.0.windows.1
Code language: CSS (css)macOS:兩種安裝方式
方式一:Xcode Command Line Tools(最簡單)
打開「終端機」,輸入:
git --version
如果還沒安裝,系統會跳出對話框問你要不要安裝 Xcode Command Line Tools,點「安裝」就好。
方式二:Homebrew(推薦給開發者)
如果你已經有 Homebrew,用這個指令安裝最新版:
brew install git
驗證安裝:
git --version
# 輸出:git version 2.43.0
Code language: CSS (css)Linux:使用套件管理器
Ubuntu / Debian
sudo apt update
sudo apt install git
CentOS / Fedora / RHEL
# Fedora
sudo dnf install git
# CentOS / RHEL
sudo yum install git
Code language: PHP (php)驗證安裝:
git --version
# 輸出:git version 2.43.0
Code language: CSS (css)初次設定:告訴 Git 你是誰
安裝完成後,第一件事是設定使用者名稱和 email。這兩個設定是必要的。
git config --global user.name "你的名字"
git config --global user.email "your.email@example.com"
Code language: CSS (css)範例:
git config --global user.name "小明"
git config --global user.email "[email protected]"
Code language: PHP (php)確認設定:
git config --global user.name
# 輸出:小明
git config --global user.email
# 輸出:[email protected]
Code language: PHP (php)一次看所有設定:
git config --list
Code language: PHP (php)輸出會像這樣:
user.name=小明
[email protected]
core.editor=code --wait
...
設定的三個層級
Git 的設定有三個層級,優先順序由高到低:
| 層級 | 範圍 | 設定檔位置 | 指令參數 |
|---|---|---|---|
| local | 單一專案 | .git/config |
--local |
| global | 目前使用者 | ~/.gitconfig |
--global |
| system | 整台電腦 | /etc/gitconfig |
--system |
這在幹嘛?
- local:只對這個專案有效。適合用不同身份提交不同專案(例如公司專案用公司 email)
- global:對目前使用者的所有專案有效。一般人用這個就夠了
- system:對電腦上所有使用者有效。很少用到
實際範例
# 全域設定(大部分時候用這個)
git config --global user.name "小明"
# 只對目前專案設定(在專案目錄內執行)
git config --local user.email "[email protected]"
Code language: PHP (php)當你在專案內提交時,Git 會先看 local 設定,沒有的話再往上找 global,最後才找 system。
其他常用設定
設定預設編輯器
Git 有時會打開編輯器讓你輸入訊息(例如合併衝突時)。預設可能是 Vim,不熟悉的話會很困擾。
設定成 VS Code:
git config --global core.editor "code --wait"
Code language: PHP (php)設定成 Notepad++(Windows):
git config --global core.editor "'C:/Program Files/Notepad++/notepad++.exe' -multiInst -notabbar -nosession -noPlugin"
Code language: PHP (php)設定預設分支名稱
新版 Git 預設分支名已經從 master 改為 main。如果你想確保一致:
git config --global init.defaultBranch main
Code language: CSS (css)這樣每次 git init 建立的新倉庫,預設分支都會是 main。
查看設定來源
想知道某個設定是從哪裡來的?
git config --show-origin user.name
# 輸出:file:/Users/ming/.gitconfig 小明
Code language: PHP (php)這告訴你設定來自 ~/.gitconfig 檔案。
Vibe Coder 檢查點
安裝 Git 後,確認這些事:
- [ ]
git --version有輸出版本號 - [ ]
git config --global user.name有設定 - [ ]
git config --global user.email有設定 - [ ] 知道自己的設定放在哪個層級
對 Vibe Coding 的幫助
學會 Git 安裝與設定後,你可以:
- 順利執行 AI 產出的 Git 指令:AI 常會建議你執行
git init、git add、git commit等指令,沒有正確安裝和設定會直接報錯 - 理解 AI 提到的設定相關建議:當 AI 說「你可能需要設定 user.name」或「檢查你的 Git 設定」,你知道它在說什麼
- 除錯設定問題:看到「Please tell me who you are」這類錯誤時,馬上知道是設定問題,用
git config --list檢查
常見問題排解
問題:git 指令找不到
'git' is not recognized as an internal or external command
Code language: JavaScript (javascript)原因:PATH 環境變數沒設好
解法:
- Windows:重新安裝,確保選了「Git from the command line」
- macOS/Linux:重新開啟終端機,或執行
source ~/.bashrc
問題:Please tell me who you are
fatal: unable to auto-detect email address
Please tell me who you are.
原因:沒設定 user.name 和 user.email
解法:
git config --global user.name "你的名字"
git config --global user.email "[email protected]"
Code language: PHP (php)下一篇預告
設定完成後,下一篇我們會:
- 建立第一個 Git 倉庫(
git init) - 學會基本的版本控制流程:add、commit、log
- 理解「工作目錄」、「暫存區」、「倉庫」的概念
本篇重點回顧
- 安裝 Git:
- Windows:Git for Windows
- macOS:Xcode Command Line Tools 或 Homebrew
- Linux:apt / yum / dnf
- 必要設定:
git config --global user.name "名字"git config --global user.email "email"
- 設定三層級:local > global > system(優先順序由高到低)
- 驗證安裝:
git --version
進階測驗:Git 安裝與初次設定
共 5 題,包含情境題與錯誤診斷題。
1. 工作與個人專案使用不同身份 情境題
--global 設定了公司 email。
對於個人專案,你應該怎麼做?
2. 新電腦設定 Git 情境題
你應該執行哪組指令?
3. 無法提交程式碼 錯誤診斷
小明剛安裝好 Git,想要提交第一個 commit,但執行後出現以下錯誤:
最可能的原因是什麼?
4. 檢查設定來源 情境題
user.name 設定是來自哪個設定檔(local、global 還是 system)。
你應該執行哪個指令?
5. Git 指令找不到 錯誤診斷
小華在 Windows 上安裝了 Git for Windows,但在命令提示字元輸入 git 後出現以下錯誤:
最可能的原因和解決方式是什麼?