Git —— The stupid content tracker。名字很直白,定位也很清楚:一個把檔案內容的每個變化都記下來的版本控制系統。
它解決的問題是「協作時如何不互相踩到」。日常流程大致是:取得程式碼 → 每天動工前先更新到最新版本 → 修改 → 提交回伺服器。以下是我的整理筆記。
下載點:git-scm.com/download(Windows、Linux、Mac 各有對應版本)。
第一次安裝後,先設定身分。加上 --global 會影響本機所有專案:
git config --global user.name "My Name"
git config --global user.email "my@email.com"
若某個專案要用不同身分(例如公司與個人帳號),進入該目錄後不加 --global 即可覆寫:
cd yourproject
git config user.name "My Name"
git config user.email "my@email.com"
查看設定:
cat .git/config
# 在當前目錄建立新倉庫
mkdir project && cd project
git init
# 檢出既有倉庫
git clone git@server:app.git myrepo
# 查看遠端倉庫
git remote -v
# 新增/刪除遠端倉庫
git remote add [name] [url]
git remote rm [name]
# 抓取遠端更新(只下載,不合併)
git fetch
# 把抓下來的內容合併進目前分支
git merge
# fetch + merge 的組合技
git pull
# 查看已暫存的差異
git diff --cached
# 加入指定檔案/加入全部
git add file1 file2 file3
git add .
# 從版控中移除
git rm file1
git rm -r dir1
# 提交
git commit -m 'this is memo'
# 跳過 add,直接提交所有已追蹤檔案的改動
git commit -a -m 'this is memo'
# 推送到遠端,團隊成員才抓得到
git push
commit 與 commit -a 的差別值得記清楚。後者等於自動做了三件事:把已追蹤檔案的所有改動加入索引、把已在索引中但工作目錄裡已不存在的檔案移除,然後才執行提交。它不會處理全新的、從未被追蹤的檔案,那些仍必須手動 git add。
# 建立 dev 分支
git branch dev
# 列出所有分支(星號為目前所在分支)
git branch
> * dev
> master
# 切換分支
git checkout dev
# 比較 master 與 dev 的差異
git diff dev
# 把指定分支合併進目前分支
git merge branchname
# 刪除分支(-D 為強制刪除未合併的分支)
git branch -d dev
git branch -D dev
# 推送/刪除遠端分支
git push origin 分支名稱
git push origin --delete 分支名稱
關於合併衝突:當 merge 無法自動解決時,Git 會把工作目錄置於衝突狀態,並告知哪些檔案需要人工處理;未衝突的部分其實已經被登記進索引了。此時執行 git diff 只會看到衝突段落,git status 則會列出所有待處理檔案。若試圖直接 commit,Git 會提示該檔案需要先合併。
解決衝突後的提交步驟:
git add file1 # 若有新增檔案
git commit
發布版本(例如 v0.1)時,可以在特定時間點打上標籤,方便日後回溯。
# 列出既有標籤
git tag
# 新增附註標籤
git tag -a v0.1 -m 'tag version 0.1'
# 推送標籤到遠端
git push --tags
# 刪除遠端標籤
git push origin --delete tag 標籤名稱
# 提交日誌;加 -p 同時顯示每次改動的內容
git log
git log -p
# 目前倉庫狀態
git status
# 回滾:產生一個反向提交,保留歷史(較安全)
git revert HEAD
git revert HEAD^
# 丟棄工作目錄的未提交修改(不可恢復,慎用)
git reset --hard
# 取消已暫存的檔案
git reset
# 比較最新版與上一版(一個 ^ 代表往前一個版本)
git diff HEAD HEAD^
# 還原被刪除的檔案
git checkout -f
revert 與 reset --hard 的差別是很多人踩過的坑:前者新增一個提交來抵銷改動,歷史完整保留,已推送的公開分支應該優先用它;後者直接把分支指標搬走並覆寫工作目錄,改動石沉大海。對已經 push 出去的分支使用 reset --hard 之後再強推,會讓其他人身上的歷史與遠端分岔。
# 首次使用
git config --global user.name "yourname"
git config --global user.email "your@email.com"
# 建立新專案並推送
mkdir projectname
cd projectname
git init
touch README
git add README
git commit -m 'first commit'
git remote add origin git@github.com:yourname/projectname.git
git push -u origin master
# 既有倉庫推到 GitHub
cd existing_git_repo
git remote add origin git@github.com:yourname/projectname.git
git push -u origin master
把這份清單當成隨身速查表即可,真正的理解來自實際用它在專案裡開分支、撞衝突、解決衝突——撞過幾次之後,這些指令自然就記住了。