Git 新手入門指南

更新日期: 2024 年 12 月 9 日

Git 是一種流行的版本控制系統,用於管理檔案的變更,特別是在軟體開發中更是不可或缺。

本篇文章將用簡單的方式介紹 Git 的基本操作,讓你快速上手。


什麼是版本控制?

版本控制就像拍照紀錄,捕捉某個時刻的狀態。

想像你去餐廳用餐,為了紀錄美食的樣子,你拍下一張照片。這張照片就是所謂的「快照 (snapshot)」,它可以讓我們在未來任何時候回到這個時刻的樣子。

Git 的版本控制就是這樣的概念,它能夠幫助我們:

  • 追蹤檔案的變更
  • 回復到先前的狀態
  • 協作管理檔案

初始設置

檢查 Git 是否安裝

在終端機輸入以下指令檢查是否安裝 Git,以及目前的版本:

git --version

初始化一個儲存庫

  1. 進入資料夾
    開啟終端機並進入目標資料夾。
  2. 初始化 Git 儲存庫
    輸入以下指令來啟用版本控制功能:
 git init
  1. 查看當前狀態
    使用以下指令檢查目前的儲存庫狀態:
git status
  1. 剛初始化後,儲存庫中應該沒有任何被追蹤的檔案。

新增檔案並檢查狀態

假設我們在資料夾中建立了一個檔案 a.html,再次輸入 git status,會看到以下輸出:

On branch master
No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        a.html

nothing added to commit but untracked files present (use "git add" to track)

這表示檔案 a.html 尚未被 Git 追蹤。

將檔案加入暫存區

暫存區是什麼?

可以將暫存區 (staging area) 想像成一個「拍照前的準備區」,我們只挑選準備好的檔案拍照。

指令:git add

將檔案加入暫存區:

git add a.html

批量加入檔案

若有多個檔案,可使用以下指令一次加入:

git add .

git add --all

注意: 批量加入檔案時務必小心,確保所有檔案已準備好提交。

取消暫存區的檔案

如果不小心加入錯誤的檔案,可以使用以下指令將檔案移出暫存區:

git restore --staged a.html

修改後重新加入

當已加入暫存區的檔案再次修改,需要再次使用 git add 更新暫存狀態。

提交變更

提交的動作

提交 (commit) 就像是拍照,將暫存區的內容永久儲存到 Git 儲存庫。

指令:git commit

提交檔案時需要加上描述標題,例如:

git commit -m "新增 a.html 檔案"

不推薦的提交標題範例:

  • 'update' 不具描述性
  • 'bug fix' 缺乏具體內容
  • '#23 bug fixed' 除非有對應的 issue 編號
  • '20241129' 日期會自動被記錄,無需額外標註

查看提交紀錄

基本指令:git log

顯示完整的提交紀錄:

git log

範例輸出:

commit c60fbcd4db11c0ce9b4f2e917f92c9c3496a78d6 (HEAD -> master)
Author: Hsu-Pei-Chun <philosophysis@example.com>
Date:   Fri Nov 29 11:14:54 2024 +0800

    third commit

commit fd07bf66d3683a34d315a3ae496abc1150d7648a
Author: Hsu-Pei-Chun <philosophysis@example.com>
Date:   Fri Nov 29 11:02:48 2024 +0800

    second commit

精簡模式:git log --oneline

顯示更簡短的提交資訊:

git log --oneline

視覺化工具

建議下載 Visual Studio Code 的 Git Graph 插件,可以用圖形化的方式查看版本歷史,更加直觀。


檢查檔案變更來源

指令:git blame 若需檢查檔案中每一行程式碼是由誰編寫,可以使用:

git blame 檔案名稱

結語

學習 Git 是軟體開發中的重要技能,它幫助我們有效管理檔案變更並提升團隊協作效率。

Similar Posts