【Git 入門教學】#02 Git 安裝與初次設定

測驗:Git 安裝與初次設定

共 5 題,點選答案後會立即顯示結果

1. 為什麼安裝 Git 後需要設定 user.name 和 user.email?

  • A. 這是 Git 的授權驗證機制
  • B. Git 需要記錄每次提交的作者資訊
  • C. 這些資訊會用來登入 GitHub
  • D. 這是為了接收 Git 的更新通知

2. 以下哪個指令可以驗證 Git 是否安裝成功?

  • A. git check
  • B. git status
  • C. git --version
  • D. git verify

3. Git 設定的三個層級中,哪個優先順序最高?

  • A. local(單一專案)
  • B. global(目前使用者)
  • C. system(整台電腦)
  • D. 三者優先順序相同

4. 執行 git config --global user.name "小明" 後,這個設定會存放在哪裡?

  • A. .git/config
  • B. ~/.gitconfig
  • C. /etc/gitconfig
  • D. /usr/local/git/config

5. 在 macOS 上安裝 Git 最簡單的方式是什麼?

  • A. 從 App Store 下載 Git 應用程式
  • B. 手動編譯 Git 原始碼
  • C. 在終端機輸入 git --version,系統會提示安裝 Xcode Command Line Tools
  • D. 使用 npm 安裝:npm install -g 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

下載安裝

  1. 前往 git-scm.com
  2. 下載安裝程式
  3. 執行安裝,大部分選項用預設即可

安裝重點

安裝過程中會問很多選項,以下是新手建議:

設定項目 建議選擇
預設編輯器 選你慣用的(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 initgit addgit 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
  • 理解「工作目錄」、「暫存區」、「倉庫」的概念

本篇重點回顧

  1. 安裝 Git
    • Windows:Git for Windows
    • macOS:Xcode Command Line Tools 或 Homebrew
    • Linux:apt / yum / dnf
  2. 必要設定
    • git config --global user.name "名字"
    • git config --global user.email "email"
  3. 設定三層級:local > global > system(優先順序由高到低)
  4. 驗證安裝git --version

進階測驗:Git 安裝與初次設定

測驗目標:驗證你是否能在實際情境中應用所學。
共 5 題,包含情境題與錯誤診斷題。

1. 工作與個人專案使用不同身份 情境題

你在公司電腦上同時開發公司專案和個人 side project。公司要求 commit 使用公司 email,但你希望個人專案用私人 email。你已經用 --global 設定了公司 email。

對於個人專案,你應該怎麼做?

  • A. 每次提交前手動修改 ~/.gitconfig
  • B. 在個人專案目錄內執行 git config --local user.email "[email protected]"
  • C. 使用 git config --system 設定私人 email
  • D. 建立另一個使用者帳號來區分

2. 新電腦設定 Git 情境題

你剛拿到一台新的 MacBook,需要設定 Git 環境。你希望預設編輯器是 VS Code,預設分支名稱是 main,並且這些設定對你所有的專案都有效。

你應該執行哪組指令?

A: git config –local core.editor “code –wait” git config –local init.defaultBranch main B: git config –global core.editor “code –wait” git config –global init.defaultBranch main C: git config –system core.editor “code –wait” git config –system init.defaultBranch main D: git config core.editor “code –wait” git config init.defaultBranch main
  • A. 選項 A(使用 –local)
  • B. 選項 B(使用 –global)
  • C. 選項 C(使用 –system)
  • D. 選項 D(不加參數)

3. 無法提交程式碼 錯誤診斷

小明剛安裝好 Git,想要提交第一個 commit,但執行後出現以下錯誤:

$ git commit -m “Initial commit” Author identity unknown *** Please tell me who you are. Run git config –global user.email “[email protected]” git config –global user.name “Your Name” to set your account’s default identity.

最可能的原因是什麼?

  • A. Git 沒有正確安裝
  • B. 沒有執行 git init
  • C. 沒有設定 user.name 和 user.email
  • D. 沒有先執行 git add

4. 檢查設定來源 情境題

你發現某個專案的 commit 作者名稱不是你預期的。你想知道目前的 user.name 設定是來自哪個設定檔(local、global 還是 system)。

你應該執行哪個指令?

  • A. git config user.name
  • B. git config --list
  • C. git config --global user.name
  • D. git config --show-origin user.name

5. Git 指令找不到 錯誤診斷

小華在 Windows 上安裝了 Git for Windows,但在命令提示字元輸入 git 後出現以下錯誤:

‘git’ is not recognized as an internal or external command, operable program or batch file.

最可能的原因和解決方式是什麼?

  • A. Git 安裝檔損壞,需要重新下載
  • B. 安裝時沒有選擇「Git from the command line」,需要重新安裝並勾選此選項
  • C. Windows 不支援 Git,需要改用 WSL
  • D. 需要先執行 git init 才能使用其他 git 指令

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *