2025-08-11 Git 初次設定

2025-08-11 Git 初次設定

「Level 0:Git 初次設定(一次就好)」**
只要做一次,未來所有 Git 專案都會正常運作。

內容我會做成 步驟式 + 指令 + 是否必要 + 為什麼要做,完全適合你這種想扎穩基礎的人。


🚀 Level 0:Git 初次設定(一次就好)

以下 8 個步驟是業界工程師新電腦設定 Git 的標準流程。


Step 0-1:設定你的名字與 Email(必做)

這是 Git 用來記錄 commit 作者。

1
2
git config --global user.name "Lily"
git config --global user.email "lily@gmail.com"

✔ 只需要做一次
✔ 所有專案共用
✔ 若接案客戶需要其他 email → 之後在專案裡做 local override


Step 0-2:把預設 branch 改成 main(必做)

新版 Git 預設 main,但有些老版本是 master。

保險做法:

1
git config --global init.defaultBranch main

🌓 Step 0-3:設定行尾(Line Ending)(建議)

你在 macOS,不同 OS 有不同的換行字元。

推薦設定:

1
git config --global core.autocrlf input

✔ macOS 標準
✔ 避免與 Windows 協作時出現換行差異造成的修改


🎨 Step 0-4:讓 Git 顯示顏色(建議)

加顏色方便閱讀。

1
git config --global color.ui auto

🔑 Step 0-5:設定 Credential Helper(非常建議)

GitHub 推薦使用 macOS Keychain 儲存 token,不然每次 push 都要輸入密碼。

1
git config --global credential.helper osxkeychain

🔐 Step 0-6:建立 SSH Key(必做,用於免密碼 push)

這是 GitHub、GitLab、Bitbucket 等必要的。

生成:

1
ssh-keygen -t rsa -b 4096 -C "lily@gmail.com"

按 Enter 三次(使用預設路徑即可)

查看公鑰:

1
cat ~/.ssh/id_rsa.pub

把輸出內容貼到 GitHub → Settings → SSH and GPG keys

完成後測試:

1
ssh -T git@github.com

看到 👇 表示成功:

1
Hi Lily! You've successfully authenticated...

🔧 Step 0-7:設定常用 Alias(選做,但工程師超愛)

讓 Git 指令變短好輸入:

1
2
3
4
5
git config --global alias.st status
git config --global alias.br branch
git config --global alias.cm "commit -m"
git config --global alias.co checkout
git config --global alias.last "log -1 HEAD"

之後你可以打:

1
2
git st   → git status
git cm "msg" → git commit -m "msg"

📝 Step 0-8:檢查所有設定是否正確(必做)

1
git config --list --show-origin

你會看到:

  • user.name / user.email
  • credential.helper
  • init.defaultBranch
  • color
  • core.autocrlf
  • alias 設定

全部都 OK 的話,表示 Git 環境初始化完成。


🎉 Level 0 完成後,你的電腦就正式成為工程師用的 Git 工作環境!

之後每個新專案你只要做:

  • git init
  • git add
  • git commit
  • git push

就好了。


📌 接下來:

如果你貼給我:

1
git config --list --show-origin

我可以幫你確認 Level 0 是否已完全設定成功。
確定完成後我們就會進入 Level 1:實作 Git 專案循環

要我幫你檢查嗎?