git常用指令清單

目錄

• 配置
  • 修改項目中的個人資訊
  • 配置自動換行
• 常見使用場景
  • 建立SSH密鑰
  • 多賬号ssh配置
  • 免密碼登入遠端伺服器
  • 檔案推向3個git庫
  • 修改遠端倉庫位址
  • 撤銷遠端記錄
  • 放棄本地的檔案修改
  • 復原到某個commit送出
  • 添加忽略檔案
  • 利用commit關閉一個issue
  • 同步fork的上遊倉庫
  • 批量修改曆史commit中的名字和郵箱
  • 檢視某個檔案曆史
  • 打造自己的git指令
• 建立倉庫
  • init
  • status
  • add
  • commit
  • remote
  • push
• clone
• 本地
  • rm
  • reset
  • revert
  • checkout
  • diff
  • stash
  • merge
  • cherry-pick
  • rebase
• 分支branch
  • 删除
  • 送出
  • 拉取
  • 分支合并
  • 重命名
  • 檢視
  • 建立
  • 連接配接
  • 分支切換
• submodule
• 删除檔案
• 标簽tag
• 日志log
• 其它
• 報錯問題解決
• 參考資料

首先是配置帳号資訊

ssh -T [email protected]

測試。

git help config # 擷取幫助資訊，檢視修改個人資訊的參數  
git config --global user.name "小弟調調"           # 修改全局名字
git config --global user.email "[email protected]"  # 修改全局郵箱
git config --list         # 檢視配置的資訊  
           

自動轉換坑太大，送出到git是自動将換行符轉換為lf

git config --global core.autocrlf input
           

這個密鑰用來跟 github 通信，在本地終端裡生成然後上傳到 github

ssh-keygen -t rsa -C '[email protected]' # 生成密鑰  
ssh-keygen -t rsa -C "[email protected]" -f ~/.ssh/ww_rsa # 指定生成目錄檔案名字
ssh -T [email protected] # 測試是否成功  
           

1.生成指定名字的密鑰

ssh-keygen -t rsa -C "郵箱位址" -f ~/.ssh/jslite_rsa

會生成

jslite_rsa

和

jslite_rsa.pub

這兩個檔案

2.密鑰複制到托管平台上

vim ~/.ssh/jslite_rsa.pub

打開公鑰檔案

jslite_rsa.pub

，并把内容複制至代碼托管平台上

3.修改config檔案

vim ~/.ssh/config

#修改config檔案，如果沒有建立

config

Host jslite.github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/jslite_rsa

Host work.github.com
  HostName github.com
  # Port 伺服器open-ssh端口（預設：22,預設時一般不寫此行）
  # PreferredAuthentications 配置登入時用什麼權限認證 
  #                          publickey|password publickey|keyboard-interactive等
  User git
  IdentityFile ~/.ssh/work_rsa
           

• Host

  這裡是個别名可以随便命名

• HostName

  一般是網站如：

  [email protected]:username/repo.git

  填寫

  github.com

• User

  通常填寫

  git

• IdentityFile

  使用的公鑰檔案位址

4.測試

ssh -T [email protected]  # `@`後面跟上定義的Host  
ssh -T work.github.com        # 通過别名測試
ssh -i ~/公鑰檔案位址 Host别名  # 如 ssh -i ~/.ssh/work_rsa work.github.com
           

5.注意

如果你修改了id_rsa的名字，你需要将ssh key添加到SSH agent中，如：

ssh-add ~/.ssh/jslite_rsa
ssh-add -l  # 檢視所有的key
ssh-add -D  # 删除所有的key
ssh-add -d  ~/.ssh/jslite_rsa # 删除指定的key
           

$ ssh-keygen -t rsa -P '' -f ~/.ssh/aliyunserver.key
$ ssh-copy-id -i ~/.ssh/aliyunserver.key.pub [email protected] # 這裡需要輸入密碼一次
           

編輯

~/.ssh/config

Host aliyun1
  HostName 192.168.182.112
  User root
  PreferredAuthentications publickey
  IdentityFile ~/.ssh/aliyunserver.key
           

上面配置完了，可以通過指令登入，不需要輸入IP位址和密碼

ssh aliyun1

1. 增加3個遠端庫位址

git remote add origin https://github.com/JSLite/JSLite.git  
git remote set-url --add origin https://gitlab.com/wang/JSLite.js.git  
git remote set-url --add origin https://oschina.net/wang/JSLite.js.git  
           

2. 删除其中一個 set-url 位址

usage: git remote set-url [--push] <name> <newurl> [<oldurl>]
   or: git remote set-url --add <name> <newurl>
   or: git remote set-url --delete <name> <url>
           

git remote set-url --delete origin https://oschina.net/wang/JSLite.js.git

3.推送代碼

git push origin master
git push -f origin master  # 強制推送  
           

4.拉代碼

隻能拉取

origin

裡的一個url位址，這個fetch-url

預設為你添加的到

origin

的第一個位址

git pull origin master   
git pull --all # 擷取遠端所有内容包括tag  
git pull origin next:master # 取回origin主機的next分支，與本地的master分支合并  
git pull origin next # 遠端分支是與目前分支合并  

# 上面一條指令等同于下面兩條指令   
git fetch origin  
git merge origin/next  
           

如果遠端主機删除了某個分支，預設情況下，git pull 不會在拉取遠端分支的時候，删除對應的本地分支。這是為了防止，由于其他人操作了遠端主機，導緻git pull不知不覺删除了本地分支。

但是，你可以改變這個行為，加上參數 -p 就會在本地删除遠端已經删除的分支。

$ git pull -p
# 等同于下面的指令
$ git fetch --prune origin 
$ git fetch -p
           

5.更改pull

隻需要更改config檔案裡，那三個url的順序即可，fetch-url會直接對應排行第一的那個utl連接配接。

git remote remove origin  # 删除該遠端路徑  
git remote add origin [email protected]:JSLite/JSLite.git  # 添加遠端路徑 
           

git reset --hard HEAD~1 # 撤銷一條記錄   
git push -f origin HEAD:master # 同步到遠端倉庫  
           

git reset --hard FETCH_HEAD # FETCH_HEAD表示上一次成功git pull之後形成的commit點。然後git pull
           

git reset --hard FETCH_HEAD

出現錯誤

git pull
You are not currently on a branch, so I cannot use any
'branch.<branchname>.merge' in your configuration file.
Please specify which remote branch you want to use on the command
line and try again (e.g. 'git pull <repository> <refspec>').
See git-pull(1) FOR details.
           

解決方法：

git checkout -b temp # 建立+切換到temp分支 
git checkout master
           

git revert HEAD~1 # 撤銷一條記錄 會彈出 commit 編輯
git push # 送出復原
           

echo node_modules/ >> .gitignore
           

這個功能在Github上可以玩兒，Gitlab上特别老的版本不能玩兒哦，那麼如何跟随着commit關閉一個issue呢? 在confirm merge的時候可以使用一下指令來關閉相關issue:

fixes #xxx

、

fixed #xxx

fix #xxx

closes #xxx

close #xxx

closed #xxx

Github教程同步fork教程

，

在Github上同步一個分支(fork)

設定添加多個遠端倉庫位址。

在同步之前，需要建立一個遠端點指向上遊倉庫(repo).如果你已經派生了一個原始倉庫，可以按照如下方法做。

$ git remote -v
# List the current remotes （列出目前遠端倉庫）
# origin  https://github.com/user/repo.git (fetch)
# origin  https://github.com/user/repo.git (push)
$ git remote add upstream https://github.com/otheruser/repo.git
# Set a new remote (設定一個新的遠端倉庫)
$ git remote -v
# Verify new remote (驗證新的原唱倉庫)
# origin    https://github.com/user/repo.git (fetch)
# origin    https://github.com/user/repo.git (push)
# upstream  https://github.com/otheruser/repo.git (fetch)
# upstream  https://github.com/otheruser/repo.git (push)
           

同步更新倉庫内容

同步上遊倉庫到你的倉庫需要執行兩步：首先你需要從遠端拉去，之後你需要合并你希望的分支到你的本地副本分支。從上遊的存儲庫中提取分支以及各自的送出内容。

master

将被存儲在本地分支機構

upstream/master

git fetch upstream
# remote: Counting objects: 75, done.
# remote: Compressing objects: 100% (53/53), done.
# remote: Total 62 (delta 27), reused 44 (delta 9)
# Unpacking objects: 100% (62/62), done.
# From https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY
#  * [new branch]      master     -> upstream/master
           

檢查你的 fork's 本地

master

分支

git checkout master
# Switched to branch 'master'
           

合并來自

upstream/master

的更改到本地 master 分支上。 這使你的前 fork's

master

分支與上遊資源庫同步，而不會丢失你本地修改。

git merge upstream/master
# Updating a422352..5fdff0f
# Fast-forward
#  README                    |    9 -------
#  README.md                 |    7 ++++++
#  2 files changed, 7 insertions(+), 9 deletions(-)
#  delete mode 100644 README
#  create mode 100644 README.md
           

1.克隆倉庫

注意參數，這個不是普通的clone，clone下來的倉庫并不能參與開發

git clone --bare https://github.com/user/repo.git
cd repo.git
           

2.指令行中運作代碼

OLD_EMAIL原來的郵箱

CORRECT_NAME更正的名字

CORRECT_EMAIL更正的郵箱

将下面代碼複制放到指令行中執行

git filter-branch -f --env-filter '
OLD_EMAIL="[email protected]"
CORRECT_NAME="小弟調調"
CORRECT_EMAIL="更正的郵箱@qq.com"
if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_COMMITTER_NAME="$CORRECT_NAME"
    export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
then
    export GIT_AUTHOR_NAME="$CORRECT_NAME"
    export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
fi
' --tag-name-filter cat -- --branches --tags
           

執行過程

Rewrite 160d4df2689ff6df3820563bfd13b5f1fb9ba832 (479/508) (16 seconds passed, remaining 0 predicted)
Ref 'refs/heads/dev' was rewritten
Ref 'refs/heads/master' was rewritten
           

3.同步到遠端倉庫

同步到push遠端git倉庫

git push --force --tags origin 'refs/heads/*'
           

我還遇到了如下面錯誤，lab預設給master分支加了保護，不允許強制覆寫。

Project(項目)

->

Setting

Repository

菜單下面的

Protected branches

把master的保護去掉就可以了。修改完之後，建議把master的保護再加回來，畢竟強推不是件好事。

remote: GitLab: You are not allowed to force push code to a protected branch on this project.
           

當上面的push 不上去的時候，先

git pull

確定最新代碼

git pull  --allow-unrelated-histories
# 或者指定分枝
git pull origin master --allow-unrelated-histories
           

git log --pretty=oneline 檔案名  # 列出檔案的所有改動曆史  
git show c178bf49   # 某次的改動的修改記錄  
git log -p c178bf49 # 某次的改動的修改記錄  
git blame 檔案名     # 顯示檔案的每一行是在那個版本最後修改。  
git whatchanged 檔案名  # 顯示某個檔案的每個版本送出資訊：送出日期，送出人員，版本号，送出備注（沒有修改細節）  
           

git config --global alias.st status
git config --global alias.br branch
git config --global alias.co checkout
git config --global alias.ci commit
           

配置好後再輸入git指令的時候就不用再輸入一大段了，例如我們要檢視狀态，隻需：

git st
           

git init

#初始化

git status

#擷取狀态

git add file

# .或*代表全部添加

git rm --cached <added_file_to_undo>

# 在commit之前撤銷git add操作

git reset head

# 好像比上面

git rm --cached

更友善

git commit -m "message"

#此處注意亂碼

git remote add origin [email protected]:JSLite/test.git

#添加源

git push -u origin master # push同僚設定預設跟蹤分支  
git push origin master  
git push -f origin master # 強制推送檔案，縮寫 -f（全寫--force）
           

git clone git://github.com/JSLite/JSLite.js.git

git clone git://github.com/JSLite/JSLite.js.git mypro

#克隆到自定義檔案夾

git clone [user@]example.com:path/to/repo.git/

#SSH協定還有另一種寫法。

git clone支援多種協定，除了HTTP(s)以外，還支援SSH、Git、本地檔案協定等，下面是一些例子。

git clone <版本庫的網址> <本地目錄名>

$ git clone http[s]://example.com/path/to/repo.git/
$ git clone ssh://example.com/path/to/repo.git/
$ git clone git://example.com/path/to/repo.git/
$ git clone /opt/git/project.git 
$ git clone file:///opt/git/project.git
$ git clone ftp[s]://example.com/path/to/repo.git/
$ git clone rsync://example.com/path/to/repo.git/
           

help

git help config # 擷取幫助資訊  
           

git add *   # 跟蹤新檔案   
git add -u [path]   # 添加[指定路徑下]已跟蹤檔案   
           

rm *&git rm *          # 移除檔案  
git rm -f *            # 移除檔案  
git rm --cached *      # 取消跟蹤  
git mv file_from file_to  # 重命名跟蹤檔案  
git log   # 檢視送出記錄  
           

git commit #送出更新   
git commit -m 'message' #送出說明   
git commit -a #跳過使用暫存區域，把所有已經跟蹤過的檔案暫存起來一并送出   
git commit --amend #修改最後一次送出   
git commit log #檢視所有送出，包括沒有push的commit    
git commit -m "#133" #關聯issue 任意位置帶上# 符号加上issue号碼  
git commit -m "fix #133" commit關閉issue  
git commit -m '概要描述'$'\n\n''1.較長的描述'$'\n''2.較長的描述' #送出簡要描述和較長的描述  
           

git reset HEAD *  # 取消已經暫存的檔案   
git reset --mixed HEAD * # 同上   
git reset --soft HEAD *  # 重置到指定狀态，不會修改索引區和工作樹   
git reset --hard HEAD *  # 重置到指定狀态，會修改索引區和工作樹   
git reset -- files *     # 重置index區檔案   
           

git revert HEAD   # 撤銷前一次操作   
git revert HEAD~  # 撤銷前前一次操作   
git revert commit # 撤銷指定操作   
           

git checkout -- file  # 取消對檔案的修改（從暫存區——覆寫worktree file）  
git checkout branch|tag|commit -- file_name  # 從倉庫取出file覆寫目前分支   
git checkout HEAD~1 [檔案]  # 将會更新 working directory 去比對某次 commit   
git checkout -- .          # 從暫存區取出檔案覆寫工作區   
git checkout -b gh-pages  0c304c9  # 這個表示 從目前分支 commit 哈希值為 0c304c9 的節點，分一個新的分支gh-pages出來，并切換到 gh-pages   
           

git diff file     # 檢視指定檔案的差異   
git diff --stat   # 檢視簡單的diff結果   
git diff  # 比較Worktree和Index之間的差異   
git diff --cached   # 比較Index和HEAD之間的差異   
git diff HEAD       # 比較Worktree和HEAD之間的差異   
git diff branch     # 比較Worktree和branch之間的差異   
git diff branch1 branch2  # 比較兩次分支之間的差異   
git diff commit commit    # 比較兩次送出之間的差異   
git diff master..test   # 上面這條指令隻顯示兩個分支間的差異  
git diff master...test    # 你想找出‘master’,‘test’的共有 父分支和'test'分支之間的差異，你用3個‘.'來取代前面的兩個'.'  
           

git stash # 将工作區現場（已跟蹤檔案）儲藏起來，等以後恢複後繼續工作。   
git stash list  # 檢視儲存的工作現場   
git stash apply # 恢複工作現場   
git stash drop  # 删除stash内容   
git stash pop   # 恢複的同時直接删除stash内容   
git stash apply stash@{0} # 恢複指定的工作現場，當你儲存了不隻一份工作現場時。   
           

git merge --squash test # 合并壓縮，将test上的commit壓縮為一條   
           

git cherry-pick commit    # 揀選合并，将commit合并到目前分支   
git cherry-pick -n commit # 揀選多個送出，合并完後可以繼續揀選下一個送出   
           

git rebase master   # 将master分之上超前的送出，變基到目前分支  
git rebase --onto master 169a6  # 限制復原範圍，rebase目前分支從169a6以後的送出  
git rebase --interactive # 互動模式，修改commit   
git rebase --continue    # 處理完沖突繼續合并   
git rebase --skip        # 跳過   
git rebase --abort       # 取消合并    
           

git push origin :branchName  # 删除遠端分支  
git push origin --delete new # 删除遠端分支new   
git branch -d branchName     # 删除本地分支，強制删除用-D  
git branch -d test      # 删除本地test分支   
git branch -D test      # 強制删除本地test分支   
git remote prune origin # 遠端删除了，本地還能看到遠端存在，這條指令删除遠端不存在的分支
           

git push -u origin branchName # 送出分支到遠端origin主機中  
           

git fetch -p

#拉取遠端分支時，自動清理 遠端分支已删除，本地還存在的對應同名分支。

git merge branchName      # 合并分支 - 将分支branchName和目前所在分支合并   
git merge origin/master   # 在本地分支上合并遠端分支。   
git rebase origin/master  # 在本地分支上合并遠端分支。   
git merge test            # 将test分支合并到目前分支   
           

git branch -m old new

#重命名分支

git branch      # 列出本地分支   
git branch -r   # 列出遠端分支   
git branch -a   # 列出所有分支   
git branch -v   # 檢視各個分支最後一個送出對象的資訊   
git branch --merge      # 檢視已經合并到目前分支的分支   
git branch --no-merge   # 檢視為合并到目前分支的分支   
git remote show origin  # 可以檢視remote位址，遠端分支
           

git branch test # 建立test分支  
git checkout -b newBrach origin/master # 取回遠端主機的更新以後，在它的基礎上建立一個新的分支  
           

git branch --set-upstream dev origin/dev     # 将本地dev分支與遠端dev分支之間建立連結  
git branch --set-upstream master origin/next # 手動建立追蹤關系  
           

git checkout test     # 切換到test分支   
git checkout -b test  # 建立+切換到test分支   
git checkout -b test dev # 基于dev建立test分支，并切換   
           

遠端

git fetch <遠端主機名> <分支名>   # fetch取回所有分支（branch）的更新  
git fetch origin remotebranch[:localbranch]   #  從遠端拉去分支[到本地指定分支]   
git merge origin/branch   # 合并遠端上指定分支   
git pull origin remotebranch:localbranch  #  拉去遠端分支到本地分支   
git push origin branch    # 将目前分支，推送到遠端上指定分支   
git push origin localbranch:remotebranch  # 推送本地指定分支，到遠端上指定分支   
git push origin :remotebranch   # 删除遠端指定分支   
git checkout -b [--track] test origin/dev # 基于遠端dev分支，建立本地test分支[同時設定跟蹤]  
           

git submodule add --force '倉庫位址' '路徑'
# 其中，倉庫位址是指子子產品倉庫位址，路徑指将子子產品放置在目前工程下的路徑。
# 注意：路徑不能以 / 結尾（會造成修改不生效）、不能是現有工程已有的目錄（不能順利 Clone）
git submodule init # 初始化submodule
git submodule update # 更新submodule(必須在根目錄執行指令)
           

當使用

git clone

下來的工程中帶有submodule時，初始的時候，submodule的内容并不會自動下載下傳下來的，此時，隻需執行如下指令：

git submodule update --init --recursive  # 下載下傳的工程帶有submodule
git submodule foreach git pull  # submodule 裡有其他的 submodule 一次更新
git submodule foreach git pull origin master # submodule更新

git submodule foreach --recursive git submodule init
git submodule foreach --recursive git submodule update
           

git rm -rf node_modules/
           

git是一個分布式代碼管理工具，是以可以支援多個倉庫，在git裡，伺服器上的倉庫在本地稱之為remote。個人開發時，多源用的可能不多，但多源其實非常有用。

git remote add origin1 [email protected]:yanhaijing/data.js.git  
git remote    # 顯示全部源  
git remote -v # 顯示全部源+詳細資訊  
git remote rename origin1 origin2 # 重命名  
git remote rm origin    # 删除  
git remote show origin  # 檢視指定源的全部資訊  
           

當開發到一定階段時，給程式打标簽是非常棒的功能。

git tag        # 列出現有标簽   
git tag v0gi.1 # 建立标簽   
git tag -a v0.1 -m 'my version 1.4' # 建立帶注釋标簽   
git checkout tagname   # 切換到标簽   
git push origin v1.5   # 推送分支到源上   
git push origin --tags # 一次性推送所有分支   
git tag -d v0.1 # 删除标簽   
git push origin :refs/tags/v0.1 # 删除遠端标簽   
git pull --all # 擷取遠端所有内容包括tag  
git --git-dir='<絕對位址>/.git' describe --tags HEAD # 檢視本地版本資訊  
           

git config format.pretty oneline  #顯示曆史記錄時，每個送出的資訊隻顯示一行   
git config color.ui true #彩色的 git 輸出   
git log #檢視最近的送出日志   
git log --pretty=oneline #單行顯示送出日志   
git log --graph --pretty=oneline --abbrev-commit   
git log -num #顯示第幾條log（倒數）   
git reflog #檢視所有分支的所有操作記錄   
git log --since=1.day #一天内的送出；你可以給出各種時間格式，比如說具體的某一天（“2008-01-15”），或者是多久以前（“2 years 1 day 3 minutes ago”）。   
git log --pretty="%h - %s" --author=自己的名字 #檢視自己的日志   
git log -p -2 #展開兩次更新顯示每次送出的内容差異   
git log --stat #要快速浏覽其他協作者送出的更新都作了哪些改動   
git log --pretty=format:"%h - %an, %ar : %s"#定制要顯示的記錄格式   
git log --pretty=format:'%h : %s' --date-order --graph # 拓撲順序展示   
git log --pretty=format:'%h : %s - %ad' --date=short #日期YYYY-MM-DD顯示   
git log <last tag> HEAD --pretty=format:%s # 隻顯示commit   
           

選項	說明
%H	送出對象（commit）的完整哈希字串	%ad	作者修訂日期（可以用 -date= 選項定制格式）
%h	送出對象的簡短哈希字串	%ar	作者修訂日期，按多久以前的方式顯示
%T	樹對象（tree）的完整哈希字串	%cn	送出者(committer)的名字
%t	樹對象的簡短哈希字串	%ce	送出者的電子郵件位址
%P	父對象（parent）的完整哈希字串	%cd	送出日期
%p	父對象的簡短哈希字串	%cr	送出日期，按多久以前的方式顯示
%an	作者（author）的名字	%s	送出說明
%ae	作者的電子郵件位址	-

重寫曆史

git commit --amend    # 改變最近一次送出  
git rebase -i HEAD~3  # 修改最近三次的送出說明，或者其中任意一次  
git commit --amend    # 儲存好了，這些訓示很明确地告訴了你該幹什麼  
git rebase --continue # 修改送出說明，退出編輯器。  
           

pick f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file
           

改成

pick 310154e updated README formatting and added blame
pick f7f3f6d changed my name a bit
           

删除倉庫

cd ..
rm -rf repo.git
           

Github官方教程

git help *  # 擷取指令的幫助資訊  
git status  # 擷取目前的狀态，非常有用，因為git會提示接下來的能做的操作  
           

1.

git fatal: protocol error: bad line length character: No s

解決辦法：更換remote位址為

http/https

的

2.

The requested URL returned error: 403 Forbidden while accessing

解決github push錯誤的辦法：

#vim 編輯器打開 目前項目中的config檔案
vim .git/config

#修改
[remote "origin"]  
    url = https://github.com/jaywcjlove/example.git  

#為下面代碼
[remote "origin"]  
    url = https://[email protected]/jaywcjlove/example.git  
           

3. git status 顯示中文問題

在檢視狀态的時候 git status 如果是中文就顯示下面的情況

\344\272\247\345\223\201\351\234\200\346\261\202
           

解決這個問題方法是：

git config --global core.quotepath false
           

• Git官網
• Github 15分鐘學習Git
• Git參考手冊
• Git簡明手冊
• Git Magic
• Git Community Book 中文版
• Pro Git
• 圖解Git
• git-簡明指南
• learnGitBranching 線上學習工具
• 初級教程
• 廖雪峰的Git教程
• 蔣鑫老師将帶你入github的大門
• git詳解
• oschina教程
• How to undo (almost) anything with Git撤銷一切，彙總各種復原撤銷的場景，加強學習。
• Git 教程 | 菜鳥教程runoob.com
• Git 本地倉庫和裸倉庫
• 沉浸式學 Git
• Git進階用法，主要是rebase進階用法