本文轉(zhuǎn)載至阮一峰
git是一種分布式的版本管理工具
都可通過ssh token來管理權(quán)限問題
git名詞解釋與命令說明
- Workspace:工作區(qū)
- Index / Stage:暫存區(qū)
- Repository:倉庫區(qū)(或本地倉庫)
- Remote:遠(yuǎn)程倉庫
新建代碼庫
# 在當(dāng)前目錄新建一個Git代碼庫
$ git init
# 新建一個目錄竭翠,將其初始化為Git代碼庫
$ git init [project-name]
# 下載一個項(xiàng)目和它的整個代碼歷史
$ git clone [url]
# 下載一個項(xiàng)目分支 默認(rèn)主機(jī)名origin
$ git clone -b [dev] [url]
# 下載一個項(xiàng)目 選擇其他主機(jī)名
$ git clone -o [origin] [url]
配置
# 添加指定文件到暫存區(qū)
$ git add [file1] [file2] ...
# 添加指定目錄到暫存區(qū)振坚,包括子目錄
$ git add [dir]
# 添加當(dāng)前目錄的所有文件到暫存區(qū)
$ git add .
# 添加每個變化前,都會要求確認(rèn)
# 對于同一個文件的多處變化斋扰,可以實(shí)現(xiàn)分次提交
$ git add -p
# 刪除工作區(qū)文件渡八,并且將這次刪除放入暫存區(qū)
$ git rm [file1] [file2] ...
# 停止追蹤指定文件,但該文件會保留在工作區(qū)
$ git rm --cached [file]
# 改名文件传货,并且將這個改名放入暫存區(qū)
$ git mv [file-original] [file-renamed]
增加/刪除文件
# 添加指定文件到暫存區(qū)
$ git add [file1] [file2] ...
# 添加指定目錄到暫存區(qū)屎鳍,包括子目錄
$ git add [dir]
# 添加當(dāng)前目錄的所有文件到暫存區(qū)
$ git add .
# 添加每個變化前,都會要求確認(rèn)
# 對于同一個文件的多處變化问裕,可以實(shí)現(xiàn)分次提交
$ git add -p
# 刪除工作區(qū)文件逮壁,并且將這次刪除放入暫存區(qū)
$ git rm [file1] [file2] ...
# 停止追蹤指定文件,但該文件會保留在工作區(qū)
$ git rm --cached [file]
# 改名文件粮宛,并且將這個改名放入暫存區(qū)
$ git mv [file-original] [file-renamed]
代碼提交
# 提交暫存區(qū)到倉庫區(qū)
$ git commit -m [message]
# 提交暫存區(qū)的指定文件到倉庫區(qū)
$ git commit [file1] [file2] ... -m [message]
# 提交工作區(qū)自上次commit之后的變化窥淆,直接到倉庫區(qū)
$ git commit -a
# 提交時顯示所有diff信息
$ git commit -v
# 使用一次新的commit卖宠,替代上一次提交
# 如果代碼沒有任何新變化,則用來改寫上一次commit的提交信息
$ git commit --amend -m [message]
# 重做上一次commit忧饭,并包括指定文件的新變化
$ git commit --amend [file1] [file2] ...
分支
# 列出所有本地分支
$ git branch
# 列出所有遠(yuǎn)程分支
$ git branch -r
# 列出所有本地分支和遠(yuǎn)程分支
$ git branch -a
# 新建一個分支扛伍,但依然停留在當(dāng)前分支
$ git branch [branch-name]
# 新建一個分支,并切換到該分支
$ git checkout -b [branch]
# 新建一個分支词裤,指向指定commit
$ git branch [branch] [commit]
# 新建一個分支刺洒,與指定的遠(yuǎn)程分支建立追蹤關(guān)系
$ git branch --track [branch] [remote-branch]
# 切換到指定分支,并更新工作區(qū)
$ git checkout [branch-name]
# 切換到上一個分支
$ git checkout -
# 建立追蹤關(guān)系吼砂,在現(xiàn)有分支與指定的遠(yuǎn)程分支之間
$ git branch --set-upstream [branch] [remote-branch]
# 合并指定分支到當(dāng)前分支
$ git merge --no-ff [branch]
# 選擇一個commit,合并進(jìn)當(dāng)前分支
$ git cherry-pick [commit]
# 刪除分支
$ git branch -d [branch-name]
# 刪除遠(yuǎn)程分支
$ git push origin --delete [branch-name]
$ git branch -dr [remote/branch]
標(biāo)簽
# 列出所有tag
$ git tag
# 新建一個tag在當(dāng)前commit
$ git tag [tag]
# 新建一個tag在指定commit
$ git tag [tag] [commit]
# 刪除本地tag
$ git tag -d [tag]
# 刪除遠(yuǎn)程tag
$ git push origin :refs/tags/[tagName]
# 查看tag信息
$ git show [tag]
# 提交指定tag
$ git push [remote] [tag]
# 提交所有tag
$ git push [remote] --tags
# 新建一個分支帅刊,指向某個tag
$ git checkout -b [branch] [tag]
查看信息
# 顯示有變更的文件
$ git status
# 顯示當(dāng)前分支的版本歷史
$ git log
# 顯示commit歷史纸泡,以及每次commit發(fā)生變更的文件
$ git log --stat
# 搜索提交歷史,根據(jù)關(guān)鍵詞
$ git log -S [keyword]
# 顯示某個commit之后的所有變動吧兔,每個commit占據(jù)一行
$ git log [tag] HEAD --pretty=format:%s
# 顯示某個commit之后的所有變動箍土,其"提交說明"必須符合搜索條件
$ git log [tag] HEAD --grep feature
# 顯示某個文件的版本歷史沟堡,包括文件改名
$ git log --follow [file]
$ git whatchanged [file]
# 顯示指定文件相關(guān)的每一次diff
$ git log -p [file]
# 顯示過去5次提交
$ git log -5 --pretty --oneline
# 顯示所有提交過的用戶绢彤,按提交次數(shù)排序
$ git shortlog -sn
# 顯示指定文件是什么人在什么時間修改過
$ git blame [file]
# 顯示暫存區(qū)和工作區(qū)的差異
$ git diff
# 顯示暫存區(qū)和上一個commit的差異
$ git diff --cached [file]
# 顯示工作區(qū)與當(dāng)前分支最新commit之間的差異
$ git diff HEAD
# 顯示兩次提交之間的差異
$ git diff [first-branch]...[second-branch]
# 顯示今天你寫了多少行代碼
$ git diff --shortstat "@{0 day ago}"
# 顯示某次提交的元數(shù)據(jù)和內(nèi)容變化
$ git show [commit]
# 顯示某次提交發(fā)生變化的文件
$ git show --name-only [commit]
# 顯示某次提交時喊崖,某個文件的內(nèi)容
$ git show [commit]:[filename]
# 顯示當(dāng)前分支的最近幾次提交
$ git reflog
遠(yuǎn)程同步
# 下載遠(yuǎn)程倉庫的所有變動
$ git fetch [remote]
# 顯示所有遠(yuǎn)程倉庫
$ git remote -v
# 顯示某個遠(yuǎn)程倉庫的信息
$ git remote show [remote]
# 增加一個新的遠(yuǎn)程倉庫,并命名
$ git remote add [shortname] [url]
# 刪除一個遠(yuǎn)程倉庫
$ git remote rm [shortname]
# 取回遠(yuǎn)程倉庫的變化雇逞,并與本地分支合并
$ git pull [remote] [branch]
# 上傳本地指定分支到遠(yuǎn)程倉庫
$ git push [remote] <本地分支名>:<遠(yuǎn)程分支名>
$ git push [remote] [branch]
# 強(qiáng)行推送當(dāng)前分支到遠(yuǎn)程倉庫荤懂,即使有沖突
$ git push [remote] --force
# 推送所有分支到遠(yuǎn)程倉庫
$ git push [remote] --all
# 刪除指定的遠(yuǎn)程分支(等同于推送空分支)
$ git push [remote] :master
$ git push [remote] --delete master
# 設(shè)置默認(rèn)主機(jī),用于省略 [remote]
$ git push -u origin master
撤銷
# 恢復(fù)暫存區(qū)的指定文件到工作區(qū)
$ git checkout [file]
# 恢復(fù)某個commit的指定文件到暫存區(qū)和工作區(qū)
$ git checkout [commit] [file]
# 恢復(fù)暫存區(qū)的所有文件到工作區(qū)
$ git checkout .
# 重置暫存區(qū)的指定文件,與上一次commit保持一致塘砸,但工作區(qū)不變
$ git reset [file]
# 重置暫存區(qū)與工作區(qū)节仿,與上一次commit保持一致
$ git reset --hard
# 重置當(dāng)前分支的指針為指定commit,同時重置暫存區(qū)掉蔬,但工作區(qū)不變
$ git reset [commit]
# 重置當(dāng)前分支的HEAD為指定commit廊宪,同時重置暫存區(qū)和工作區(qū),與指定commit一致
$ git reset --hard [commit]
# 重置當(dāng)前HEAD為指定commit女轿,但保持暫存區(qū)和工作區(qū)不變
$ git reset --keep [commit]
# 新建一個commit箭启,用來撤銷指定commit
# 后者的所有變化都將被前者抵消,并且應(yīng)用到當(dāng)前分支
$ git revert [commit]
# 暫時將未提交的變化移除蛉迹,稍后再移入
$ git stash
$ git stash pop
其他
關(guān)于分支的一些約定:
- 默認(rèn)master是對外主分支
- dev是公共開發(fā)分支
- 修補(bǔ)bug: 從dev創(chuàng)建fixbug-0.1分支,修補(bǔ)結(jié)束后merge回dev分支并刪除fixbug分支
- 添加功能: 從dev創(chuàng)建feature-x分支,開發(fā)結(jié)束后merge回dev分支并刪除fixbug分支
- 發(fā)布預(yù)覽: 從dev創(chuàng)建release-1.2分支,結(jié)束后merge回dev分支并刪除fixbug分支
關(guān)于commit的一些約定:
- feat:新功能(feature)
- fix:修補(bǔ)bug
- docs:文檔(documentation)
- style: 格式(不影響代碼運(yùn)行的變動)
- refactor:重構(gòu)(即不是新增功能傅寡,也不是修改bug的代碼變動)
- test:增加測試
- chore:構(gòu)建過程或輔助工具的變動
Commitizen是一個撰寫合格 Commit message 的工具。
$ npm install -g commitizen
# 運(yùn)行下面的命令婿禽,使其支持 Angular 的 Commit message 格式
$ commitizen init cz-conventional-changelog --save --save-exact
# 生成一個可供發(fā)布的壓縮包
$ git archive
# 解決 Git refusing to merge unrelated histories 問題
$ git pull origin master --allow-unrelated-histories