Git教學：本地Git Bash終極指南 (2025版)

如何在本地使用 Git 和 Git Bash：一個綜合指南

Git 是一個分散式版本控制系統，它能幫助你追蹤代碼的變更、與他人協作並維護項目的歷史紀錄。Git Bash 是一個為 Windows 提供的終端應用程序，提供類 Unix 的命令行體驗，用於使用 Git。

本指南將指導你如何設置 Git，使用 Git Bash，並掌握基本的 Git 命令來進行本地開發。

安裝

Windows
從 git-scm.com 下載 Git for Windows
運行安裝程序，選擇默認選項（或根據需要自定義）
Git Bash 將會自動安裝作為該包的一部分

macOS
使用 Homebrew 安裝 Git：brew install git
或者，從 git-scm.com 下載

Linux
對於 Debian/Ubuntu 系統：sudo apt-get install git
對於 Fedora 系統：sudo dnf install git
對於其他發行版，使用適當的包管理器

驗證安裝
打開 Git Bash（Windows）或 Terminal（macOS/Linux），並輸入以下命令：

這應該顯示已安裝的 Git 版本。

Git Bash 基本操作

Git Bash 為 Windows 提供類 Unix 的命令行體驗。以下是一些基本命令：

導航命令
pwd – 顯示當前工作目錄
ls – 列出文件和目錄
cd [目錄] – 進入目錄
mkdir [目錄] – 創建新目錄
rm [文件] – 刪除文件
rm -r [目錄] – 刪除目錄及其內容

文件操作
touch [文件名] – 創建一個空文件
cat [文件名] – 顯示文件內容
nano [文件名] 或 vim [文件名] – 在終端中編輯文件

鍵盤快捷鍵
Ctrl + C – 終止當前命令
Ctrl + L – 清除屏幕
Tab – 自動完成命令或文件名
上下箭頭 – 瀏覽命令歷史

Git 配置
在使用 Git 之前，先配置你的身份：

其他配置
設置默認編輯器：
啟用彩色輸出：
查看所有配置：

基本 Git 工作流程

初始化一個庫
導航到你的項目文件夾並初始化一個 Git 倉庫：

查看狀態
查看哪些文件已經被追蹤、修改或已暫存：

暫存文件
將文件添加到暫存區：

提交變更
將暫存的變更保存到倉庫：

或者打開編輯器來寫更詳細的提交信息：

查看提交歷史

分支和合併

處理分支
創建一個新分支：
切換到一個分支：
在一條命令中創建並切換到新分支：
列出所有分支：

合併分支
將另一個分支的變更合併到當前分支：

處理合併衝突
當 Git 無法自動合併變更時，您需要手動解決衝突：
Git 會標記衝突文件
打開文件並查找衝突標記（<<<<<<>>>>>）
編輯文件以解決衝突
添加解決衝突後的文件：git add
完成合併：git commit

刪除分支
合併後刪除分支：

遠程倉庫

添加遠程倉庫

查看遠程倉庫

推送到遠程倉庫

從遠程倉庫拉取

克隆倉庫

高級 Git 命令

暫存變更
臨時保存修改過的文件，以便處理其他事務：

還原變更
撤銷提交：

交互式變基
重寫、合併或重排提交：

故障排除

常見問題及解決方法

問題：「fatal: not a git repository」
解決方法：確保你在正確的目錄中，或者使用 git init 初始化倉庫

問題：無法推送到遠程倉庫
解決方法：
檢查你是否擁有正確的權限
先拉取最新的變更：git pull origin main
檢查遠程 URL 是否正確：git remote -v

問題：合併衝突
解決方法：手動解決衝突，然後 git add 解決過的文件並 git commit

問題：錯誤的提交
解決方法：使用 git reset –soft HEAD~1 撤銷上一次提交，同時保留變更

Git 最佳實踐

經常提交，並提供清晰且具描述性的提交信息
為新特性或錯誤修復創建分支
在推送之前先拉取，以減少衝突
寫有意義的提交信息，解釋為何進行變更
使用 .gitignore 排除不必要的文件（例如構建產物、依賴項等）
在提交前檢查變更，使用 git diff 和 git status
保持提交專注於單一邏輯變更
使用標籤來標記版本或重要的里程碑
定期備份你的倉庫
記錄你的 Git 工作流程，以便團隊協作

.gitignore 範例
在倉庫根目錄創建 .gitignore 文件：

根據你的項目具體需求定制此文件。

結論
Git 和 Git Bash 為版本控制和協作開發提供了強大的工具。在本指南中，我們涵蓋了各平台的安裝、基本的 Git Bash 命令、倉庫初始化、核心的添加-提交工作流程、分支策略、遠程倉庫管理以及像暫存和變基這樣的高級操作。我們還解決了常見的故障排除場景並提供了保持工作流程乾淨的最佳實踐。掌握了這些基本知識後，你現在已經能夠有效地追蹤變更、協作並保持項目結構化的歷史紀錄。

—

**編輯評論與反思**：
這篇文章提供了一個相對完整的指南，涵蓋了 Git 的基礎操作到高級功能，對於初學者來說非常實用，特別是對於 Windows 用戶，因為 Git Bash 提供了一個接近 Unix 的操作體驗，讓跨平台開發變得更加輕鬆。然而，對於有一定經驗的開發者，這篇文章可能顯得過於簡單，沒有深入探討 Git 的高級功能，像是子模組、分支策略等細節，也未提及常見的 Git 配置錯誤或一些較為複雜的操作。可以進一步增強在團隊合作中的版本控制策略的討論，特別是如何在多人協作中避免常見的衝突情況，以及如何更高效地管理大型代碼庫。

以上文章由特價GPT API KEY所翻譯及撰寫。而圖片則由FLUX根據內容自動生成。