Git 新手入門：常用命令速查表¶

Git 是一款強大的版本控制系統，能幫你追蹤文件變化、協作開發、回滾代碼。對於初學者，掌握核心命令是上手的關鍵。這份速查表整理了最常用的 Git 命令，附帶簡單解釋和示例，方便隨時查閱。

一、基礎配置與倉庫初始化¶

1. 配置用戶信息（全局/局部）¶

• git config --global user.name "你的名字"
  設置全局用戶名（對所有倉庫生效），後續提交會關聯此信息。
  示例：git config --global user.name "張三"

• git config --global user.email "你的郵箱"
  設置全局郵箱（必填，否則提交會報錯）。
  示例：git config --global user.email "zhangsan@example.com"

• git config user.name "局部倉庫名"
  僅對當前倉庫生效，覆蓋全局設置（可選，新手建議先用全局）。

2. 初始化本地倉庫¶

• git init
  在當前目錄創建一個空的 Git 倉庫（或初始化已有目錄爲倉庫）。
  示例：在桌面新建文件夾，打開終端執行 git init

二、工作區與暫存區操作¶

1. 查看文件狀態¶

• git status
  查看工作區、暫存區的文件變化（哪些文件新增、修改、未跟蹤）。
  示例：執行後會顯示 "changes to be committed" 等狀態提示

2. 將文件添加到暫存區¶

• git add [文件名]
  將指定文件從「工作區」添加到「暫存區」（準備提交）。
  示例：git add test.txt（僅添加 test.txt）

• git add .
  將當前目錄所有修改/新增文件添加到暫存區（. 表示當前目錄）。
  示例：git add .（添加所有未跟蹤文件）

3. 提交暫存區到版本庫¶

• git commit -m "提交信息"
  將暫存區的更改永久保存到本地版本庫，-m 後需寫清晰的提交描述（必填！）。
  示例：git commit -m "添加了 README 說明文檔"

三、分支操作¶

1. 創建與切換分支¶

• git branch [分支名]
  創建一個新分支（僅創建，不切換）。
  示例：git branch dev（創建名爲 dev 的開發分支）

• git checkout -b [分支名]
  創建並切換到新分支（最常用的分支操作命令）。
  示例：git checkout -b feature/login（創建並切換到登錄功能分支）

2. 合併分支¶

• git merge [目標分支]
  將指定分支的更改合併到當前分支（需先切換到目標分支）。
  示例：git checkout master（先切回主分支）→ git merge dev（合併 dev 分支到 master）

3. 查看分支列表¶

• git branch
  查看本地所有分支，當前分支前有 * 標記。
  示例：執行後會顯示 master*、dev 等分支

• git branch -r
  查看遠程倉庫的分支（如 origin/master）。

四、遠程倉庫操作¶

1. 關聯遠程倉庫¶

• git remote add origin [遠程倉庫地址]
  將本地倉庫關聯到遠程倉庫（首次連接時用），origin 是默認遠程倉庫名。
  示例：git remote add origin https://github.com/yourname/yourrepo.git

• git remote -v
  查看遠程倉庫地址（確認關聯是否成功）。

2. 拉取與推送代碼¶

• git pull origin [分支名]
  從遠程倉庫拉取代碼併合併到本地分支（相當於「拉取+更新」）。
  示例：git pull origin master（拉取遠程 master 分支到本地）

• git push origin [分支名]
  將本地分支的更改推送到遠程倉庫（首次推送需加 -u 建立跟蹤關係）。
  示例：git push -u origin dev（首次推送 dev 分支到遠程）

五、撤銷與恢復操作¶

1. 撤銷暫存區文件¶

• git reset HEAD [文件名]
  將暫存區的文件回退到「工作區」（取消 git add）。
  示例：git reset HEAD test.txt（取消暫存 test.txt）

2. 撤銷最近一次提交¶

• git reset --soft HEAD~1
  保留工作區和暫存區，僅撤銷最近一次提交（回到暫存區）。
  示例：git reset --soft HEAD~1（撤銷上一次 commit）

• git reset --hard HEAD~1
  徹底回滾（工作區、暫存區、版本庫全回退），慎用！會丟失數據。

3. 放棄工作區修改¶

• git checkout -- [文件名]
  丟棄工作區中指定文件的修改（恢復到最近一次提交狀態）。
  示例：git checkout -- app.js（放棄 app.js 的本地修改）

六、查看提交歷史¶

• git log
  查看所有提交記錄，包括提交 ID、作者、時間、描述。
  常用參數：git log --oneline（簡化輸出，一行顯示）、git log --graph（圖形化分支歷史）

七、解決常見問題¶

1. 分支合併衝突¶

• 場景：合併分支時，Git 提示「Automatic merge failed」。
• 解決：打開衝突文件（標記 <<<<<<< HEAD 到 ======= 是本地代碼，======= 到 >>>>>>> 分支名 是合併代碼），手動修改後保存，執行 git add [文件名] → git commit。

2. 暫存未完成工作¶

• git stash
  暫存當前工作區的修改（如突然要切換分支），執行 git stash pop 恢復暫存內容。

總結¶

Git 命令需在實踐中熟悉，建議多動手操作。遇到問題時，先用 git --help [命令] 查看幫助，或搜索錯誤提示。記住：git add → git commit 是基礎，分支和遠程操作是協作核心。

（收藏本文，遇到問題隨時翻查！）