Git 核心指南：從入門到精通的實戰命令詳解
為什么選擇 Git？
在現代軟件開發中，版本控制系統 (VCS) 是不可或缺的基石。Git 作為其中的佼佼者，是一種分布式版本控制系統，憑借其免費、開源、高效和輕量等特性，已成為全球開發者的首選。
Git 的核心優勢：
- 快照機制 (Snapshot)：與許多只記錄文件差異的 VCS 不同，Git 將每次提交都視為一次項目快照。它會記錄下所有文件的完整狀態，對于未修改的文件，則通過一個鏈接指向其上一個版本。這種設計使得 Git 在切換分支、查看歷史等操作時速度極快，仿佛在項目的不同時間點“拍照”留存。
- 分布式架構：每個開發者本地都擁有一份完整的代碼倉庫（Repository），包含全部歷史記錄。這意味著您可以在沒有網絡連接的情況下，在本地完成提交、查看歷史、創建分支等絕大部分操作，極大地提升了開發靈活性和效率。
基礎配置：定制你的 Git 環境
在開始使用 Git 之前，進行一些基礎配置是必要的。
1. 用戶信息
每次 Git 提交都會使用這些信息，它們會被永久記錄在你的提交歷史中。
- 查看當前所有配置：
git config --list- 設置全局用戶信息(對系統上所有倉庫生效):
# 直接修改配置文件 `~/.gitconfig` 也是一種方式
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"- 設置特定倉庫用戶信息(僅對當前倉庫生效，會覆蓋全局配置):
# 該配置保存在項目目錄的 `.git/config` 文件中
git config --local user.name "Your Project-Specific Name"
git config --local user.email "project.email@example.com"2. SSH 密鑰配置
為了安全地與遠程倉庫（如 GitHub、GitLab）通信，推薦使用 SSH 協議。
- 檢查現有 SSH 密鑰：
ls -al ~/.ssh如果輸出中包含 id_rsa.pub或 id_ed25519.pub等文件，說明密鑰已存在，可以跳過生成步驟。
- 生成新的 SSH 密鑰：
ssh-keygen -t rsa -b 4096 -C "your.email@example.com"按照提示操作，建議直接回車使用默認路徑和設置空密碼（除非有特殊安全需求）。
- 啟動 SSH Agent 并添加密鑰：
eval "$(ssh-agent -s)" # 啟動 agent
ssh-add ~/.ssh/id_rsa # 將密鑰添加至 agent- 將公鑰添加至遠程倉庫：
# 復制公鑰內容到剪貼板
pbcopy < ~/.ssh/id_rsa.pub然后，登錄你的 GitHub 或其他 Git 服務，在個人設置的 "SSH and GPG keys" 頁面，將復制的公鑰粘貼進去。
- 測試連接：
# 注意：請將 XXX.XX.X.XX 替換為你的 Git 服務器地址，例如 GitHub 是 git@github.com
ssh -T git@github.com如果看到 "Hi username! You've successfully authenticated..." 的歡迎信息，說明配置成功。
3. 命令別名 (Alias)
為常用且較長的命令設置別名，可以顯著提升日常操作效率。
# 示例：將 status 簡化為 st
git config --global alias.st status
# 更多實用別名
git config --global alias.co checkout
git config --global alias.br branch
git config --global alias.ci commit
git config --global alias.lg "log --oneline --graph --decorate --all"現在，你可以用 git st代替 git status，用 git lg查看簡潔美觀的提交歷史圖。
核心概念：理解 Git 的三大區域
要真正掌握 Git，必須理解其設計的核心——三大工作區域和文件的三種狀態。這構成了 Git 操作的邏輯基礎。
- 工作區 (Working Directory)：
是什么：你電腦上能直接看到和編輯的項目文件夾。
這是你的辦公桌。你在這里起草文件、修改代碼、刪除圖表，所有的實際工作都在這里發生。
- 暫存區 (Staging Area / Index)：
是什么：一個位于 .git目錄下的特殊文件，它記錄了你計劃在下一次提交中包含的變更。
這是你的文件待辦箱或提案草稿。你將辦公桌上完成的一部分工作（比如一個功能的代碼）放入這個箱子，表示“這部分已經準備好了，可以正式歸檔了”。你可以隨時從箱子里拿出或放入文件。
- 本地倉庫 (Repository)：
是什么：項目的所有歷史記錄和版本信息都存儲在這里，位于項目根目錄下的 .git隱藏文件夾中。
這是公司的中央檔案室。當你執行 commit操作時，就等于將“待辦箱”里的所有文件正式蓋章、存檔，形成一個不可更改的永久記錄（一個 Commit）。
文件的三種狀態
與三大區域相對應，文件也因此具有三種流轉狀態：
- 已修改 (Modified)：文件在工作區被修改，但尚未放入暫存區。
- 已暫存 (Staged)：執行
git add后，文件的當前版本變更被記錄到暫存區，等待下一次提交。 - 已提交 (Committed)：執行
git commit后，暫存區的變更被安全地保存到本地倉庫，形成一個新的版本快照。
這個 工作區 -> 暫存區 -> 本地倉庫的流程是 Git 最核心的工作流。
Git 常用指令詳解
項目初始化與狀態檢查
- git init
在當前目錄初始化一個新的 Git 倉庫。它會創建一個 .git 隱藏目錄，所有 Git 的元數據和對象數據庫都存放在此。 - git status
檢查當前工作區和暫存區的狀態。這是最常用的命令之一，它會告訴你哪些文件被修改、哪些是新增的、哪些已暫存等。 - git diff
查看變更的具體內容。
git diff：比較 工作區與 暫存區的差異。
git diff --cached(或 --staged)：比較 暫存區與 最新提交 (HEAD)的差異。
git diff HEAD：比較 工作區與 最新提交 (HEAD)的差異。
git diff <commit1> <commit2>：比較兩次不同提交之間的差異。
核心工作流：Add & Commit
- git add
將文件的變更從工作區添加到暫存區。
git add .或 git add -A：將所有變更（包括新增、修改、刪除）都添加到暫存區。
git add -p：交互式暫存。Git 會逐一展示每個變更的代碼塊（hunk），讓你決定是否要暫存該部分，非常適合在一次提交中只包含部分修改。
git add -f <file>：強制添加被 .gitignore規則忽略的文件。
- git commit
將暫存區的所有變更創建為一個新的提交記錄，并保存到本地倉庫。
git commit -m "Your descriptive message"：附加一條提交信息，這是最常用的方式。
git commit -a -m "Message"：跳過 git add步驟，直接將所有已跟蹤文件的修改暫存并提交。注意：此命令對新創建的未跟蹤文件（Untracked File）無效。
git commit --amend：修改最后一次的提交。可以用來修改提交信息，或者將當前暫存區的變更合并到上一次提交中，而不會產生新的 Commit。
歷史記錄查看與追溯
- git log
顯示從近到遠的提交歷史。
git log --oneline：以單行簡潔模式顯示。
git log --graph：以圖形化方式展示分支的合并歷史。
git log -p <file_name>：顯示特定文件的詳細提交歷史及其每次變更的內容。
git log -S "some_string"：搜索提交內容中包含特定字符串的提交記錄。
git log --author="Author Name"：按作者篩選提交記錄。
- git blame <file_name>
逐行顯示指定文件的內容，并標注每一行是由誰在哪次提交中最后修改的。是代碼溯源和“甩鍋”的利器。 - git show <commit_hash>
顯示某次提交的詳細信息，包括提交元數據和具體的代碼變更。
文件管理
- git rm
從工作區和暫存區中刪除文件。這等同于手動執行 rm 再 git add 。 - git mv <old_name> <new_name>
重命名或移動文件。這等同于 mv <old_name> <new_name> 后再執行 git add。
撤銷操作：安全地“反悔”
在 Git 中有多種“反悔”的方式，適用于不同場景。
場景1：修改尚未提交
- 撤銷工作區的修改：
# 丟棄某個文件的所有本地修改，恢復到和暫存區或上次提交一致的狀態
git checkout -- <file_name>
# 丟棄所有文件的本地修改
git checkout .- 將文件從暫存區移回工作區 (Unstage)：
git reset HEAD <file_name>這個操作很安全，它只改變暫存區，不會修改工作區的文件內容。
場景2：撤銷已提交的更改 (Reset vs. Revert)
這是 Git 中一個至關重要的概念，reset和 revert都能撤銷提交，但原理和適用場景完全不同。
- git reset (時光機：重寫歷史)
reset 命令會移動 HEAD 指針到指定的提交，同時根據模式選擇性地修改暫存區和工作區。它會改變提交歷史，請謹慎在共享分支上使用！
示例：撤銷最近一次提交
# 變更保留在工作區
git reset HEAD^
# 變更保留在暫存區
git reset --soft HEAD^
# 徹底丟棄變更
git reset --hard HEAD^git reset --soft <commit>：最輕柔。僅移動 HEAD指針，你的工作區和暫存區都保持不變。常用于合并多個提交。
git reset --mixed <commit>(默認模式)：移動 HEAD指針，并重置暫存區。工作區文件內容不變，但所有變更都變為“未暫存”狀態。
git reset --hard <commit>：最具破壞性。移動 HEAD指針，同時重置暫存區和工作區，所有未提交的本地變更都會被永久刪除。
- git revert (打補丁：創建一次反向操作)
revert 會創建一個新的提交，其內容與你想要撤銷的那個提交完全相反。
優點：它不修改項目歷史，而是向前追加一次“撤銷提交”。這對于已經推送到遠程的共享分支來說，是唯一安全的撤銷方式。
# 撤銷最近一次提交，并生成一個新的“revert”提交
git revert HEAD --no-edit總結：在個人分支上，你可以用 reset整理歷史；在團隊協作的公共分支上，請務必使用 revert來撤銷更改。
分支管理：并行開發
分支是 Git 的核心特性，它允許你偏離主線進行獨立的開發，完成后再安全地合并回來。
git branch：列出所有本地分支，并標記當前所在分支。git branch <branch_name>：創建一個新分支（但不會切換過去）。git checkout <branch_name>：切換到指定分支。git checkout -b <branch_name>：創建并立即切換到新分支 (相當于branch+checkout)。git branch -d <branch_name>：刪除一個已合并的分支。git branch -D <branch_name>：強制刪除一個分支（即使它還沒被合并）。
合并分支：Merge & Rebase
將不同分支的工作成果匯合到一起有兩種主要方式：merge和 rebase。
- git merge <branch_name>
將指定分支的歷史合并到當前分支。默認情況下，如果可能，Git 會使用 "Fast-forward"（快進）模式。如果不是，它會創建一個新的合并提交 (Merge Commit)，將兩個分支的歷史連接起來。
# 切換到主分支
git checkout master
# 合并 feature 分支
git merge feature
# --no-ff 參數可以強制創建一個合并提交，即使可以快進，從而保留分支的開發歷史
git merge --no-ff feature優點：保留了真實、完整的項目歷史，包括每一次分支和合并。
缺點：如果分支繁多，提交歷史圖會變得非常復雜，難以閱讀。
- git rebase <base_branch>
Rebase（變基）是另一種合并方式，它能創造出更線性的提交歷史。它會把你當前分支的所有提交“暫存”起來，然后將分支的起點移動到目標分支的最新提交上，最后再逐一應用之前暫存的提交。
# 切換到 feature 分支
git checkout feature
# 將 feature 分支的基底變更為 master
git rebase master優點：產生一個非常整潔、線性的提交歷史，如同所有開發都是串行進行的一樣。
缺點：它重寫了提交歷史。絕對不要在已經推送到遠程的公共分支上執行 rebase 操作，否則會給協作者帶來巨大的麻煩。
rebase -i (交互式變基)：這是 Rebase 最強大的功能，你可以用它來合并（squash）、編輯（edit）、刪除（drop）或重排（drag-and-drop a line）一系列提交，是保持提交歷史干凈整潔的終極武器。
遠程倉庫協作
- git clone <repository_url>
從遠程地址克隆一個完整的倉庫副本到本地，包括所有代碼、分支和歷史記錄。 - git remote add
添加一個新的遠程倉庫連接，通常我們把主倉庫命名為 origin。 - git fetch <remote_name>
從遠程倉庫下載最新的歷史記錄和對象，但不會自動合并或修改你當前的工作。它只會更新你的遠程跟蹤分支（如 origin/master）。 - git pull <remote_name> <branch_name>
拉取遠程分支的更新并與本地分支合并。它本質上是 git fetch 和 git merge 兩個命令的組合。 - git push <remote_name> <branch_name>
將本地分支的提交推送到遠程倉庫。
git push origin --delete <remote_branch_name>：刪除一個遠程分支。
git push -f(或 --force)：強制推送。這會用你的本地歷史覆蓋遠程歷史，非常危險，通常只在你知道自己在做什么（比如 rebase 個人分支后）時才使用。
其他實用工具
- git stash
當你正在處理一個復雜的功能，但需要緊急切換到其他分支修復一個 bug 時，git stash 可以幫你保存當前工作區和暫存區的全部變更，讓你的工作目錄變干凈。修復完 bug 后，再切回來 git stash pop 即可恢復之前的工作狀態。
git stash：儲藏變更。
git stash list：查看所有儲藏。
git stash pop：恢復最近的儲藏并從列表中刪除。
git stash apply：恢復儲藏，但保留在列表中。
- git cherry-pick <commit_hash>
“揀選”一個或多個其他分支的提交，并將其應用到當前分支。這在需要將某個特定 bug 修復應用到多個發布分支時非常有用。 - git tag
為項目歷史中的某個特定時間點（通常是某個 commit）創建一個永久性的標記，最常見的用法是標記軟件的發布版本（如 v1.0.0）。
結語
掌握 Git 不僅是學習一系列命令，更重要的是理解其背后的設計哲學：快照、分支、以及清晰的區域劃分。本文覆蓋了從基礎配置到高級協作的大部分常用命令和核心概念。希望這份經過優化的指南能成為您在開發道路上可靠的伙伴，幫助您更高效、更自信地駕馭代碼版本。持續練習，將這些命令融入日常工作流，您將發現 Git 的真正威力。
