Skip to content

基本初始化設定

1. 設定使用者名稱與電子郵件

為什麼要設定?

  • Git 需要你的名稱與 Email 來記錄每一次的提交 (commit)。
  • 未設定的話,每次提交都會出現錯誤或使用預設值,導致提交記錄中看不出是誰進行的修改,特別是在多人協作時會造成混亂。
git config --global user.name "你的名稱"
git config --global user.email "你的Email"
  • --global:為整個系統設定 (所有 Git 專案皆適用)。
  • 若只想針對「單一專案」設定,移除 --global 即可:
git config user.name "你的名稱"
git config user.email "你的Email"

2. 設定預設的文字編輯器

為什麼要設定?

  • 當 Git 需要你輸入 commit 訊息或編輯設定時,會呼叫預設的文字編輯器 (如 Vim)。
  • 未設定的話,可能會使用你不熟悉的編輯器,導致無法正確操作。
git config --global core.editor "code --wait"  # 使用 VS Code
git config --global core.editor "nano"         # 使用 Nano

3. 設定行為習慣 (可選)

git config --global core.autocrlf true   # 自動轉換行結尾格式 (Windows)
git config --global core.autocrlf input  # macOS/Linux 使用此設定

4. 驗證設定

git config --list
  • 可以列出目前所有的 Git 設定。

未進行設定的影響

  1. 每次提交時出錯

    Git 會提醒你「未設定使用者名稱與 Email」,並拒絕提交。

  2. 無法區分誰提交的程式碼

    Git 會將 unknown 作為提交者,失去提交記錄的意義,特別在團隊合作時會混亂。

  3. 編輯器使用不便

    若預設使用 Vim,初學者可能無法順利退出或編輯,浪費時間。

建議

安裝完 Git 後務必先進行這些設定,確保每次提交都有正確的「身分標記」!