建立 2024-01-01 更新 2026-09-15

基本初始化設定

安裝 Git 之後、第一次 commit 之前，至少要設定名稱與 Email。Git 用它們標記「這次是誰改的」；沒設的話提交會失敗，或變成看不出作者的紀錄。

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

git config --global user.name "你的名稱"
git config --global user.email "你的Email"

• --global：這台電腦上所有專案都用同一組身分。
• 若只想針對「單一專案」設定，去掉 --global，在該專案目錄執行即可。

Email 建議與 GitHub 帳號相同（或使用 GitHub 提供的 noreply 信箱），頭像與貢獻圖才對得上。

設定預設的文字編輯器

當 Git 需要你輸入較長的 commit 訊息或解決 rebase 時，會打開編輯器。不熟 Vim 的話，改成 VS Code 比較不容易卡住：

git config --global core.editor "code --wait"  # 使用 VS Code
git config --global core.editor "nano"         # 使用 Nano

code --wait 需要 VS Code 已把 code 命令裝進 PATH（命令選擇區執行 Shell Command: Install 'code' command in PATH）。

設定換行字元（可選）

Windows 與 macOS／Linux 的換行字元不同，團隊混用時容易出現整檔被標成「全改過」。

git config --global core.autocrlf true   # Windows
git config --global core.autocrlf input  # macOS / Linux

驗證設定

git config --list

列出目前所有設定。找不到 user.name 就還不能安心提交。

未設定會怎樣

1. 無法提交：Git 會提示未設定使用者名稱與 Email。
2. 作者資訊沒意義：紀錄對協作與 git blame 都幫不上忙。
3. 編輯器卡住：預設進 Vim 時，不知道怎麼存檔離開會浪費很多時間。