Git原理和技巧¶
Git本质上是一个内容寻址(content-addressable)文件系统,并在此之上提供了一个版本控制系统的用户界面。了解底层原理,可以更好的帮助我们理清思路,知道真正在操作什么,而不会迷失在大量的指令和参数上。
原理¶
区域¶
工作区(Working Directory),就是我们在电脑里看到的目录,我们对文件进行增、改、删都发生在这个目录中。
在这里目录中,有一个隐藏目录.git
就是git的版本库(Repository)。
版本库中存了很多东西,其中还有一片区域,一般为.git/index
文件,我们称为stage(或index)暂存区。
再加上远程仓库,例如github上的repo,我们平时做的大量操作都是把文件在这四个区域之间相互移动。
对象¶
在git中,除了init
、clone
等我们常用的高层命令(被称为porcelain)之外,还有一些底层命令(被称为plumbing)。例如git hash-object
把一个文件转换为一个git对象,git cat-file
可以打印出一个git对象。
那么git对象到底是什么呢?因为Git的核心是一个内容寻址文件系统,可以理解为一个简单的键值对数据库。当我们向它插入一个任意类型的内容时,它会返回一个键值对,通过键值对能够在任意时刻再次检索到该内容。
当我们初始化时,.git
中会有一个文件夹objects
专门存储git对象:
➜ testgit git init
Initialized empty Git repository in /home/hejl/testgit/.git/
➜ testgit git:(master) ls .git
HEAD branches config description hooks info objects refs
当我们添加一项内容的时候,这个objects文件夹就会多出一个文件:
➜ testgit git:(master) echo 'abc' > test.txt
➜ testgit git:(master) ✗ git add .
➜ testgit git:(master) ✗ tree .git/objects/
.git/objects/
├── 8b
│ └── aef1b4abc478178b004d62031cf7fe6db6f903
├── info
└── pack
3 directories, 1 file
sha1
算法计算出文件内容也就是abc
的hash值,是一个40位的16进制的字符串,字符串的前两位作为一个文件夹名称,后38位作为文件名称。因为大多数的文件系统都讨厌单个目录中包含太多的文件,这会减慢其爬取的速度,Git用这个方法使得第一级目录最多256个。文件本身就是Git object,它的头部定义了类型,紧跟着是一个ASCII的空格(0x20),然后是对象的大小多少字节,紧跟着一个null(0x00),最后是对象本身的内容。整个文件通过zlib
压缩存储。
有四种类型的对象,它们分别是blob
,commit
,tree
,tag
。对象的寻址我们也可以通过伪码来表达:
type object = blob | commit | tree | tag
objects = map<string, object>
def store(object):
id = sha1(object)
objects[id] = object
def load(id):
return objects[id]
type blob = array<byte>
type tree = map<string, tree | file>
type commit = struct{
parent: array<commit>
author: string
message: string
snapshot: tree
}
blob¶
该种类型的对象存储的原始内容,例如刚才新增的对象就是这种类型:
➜ testgit git:(master) ✗ git cat-file -t 8bae
blob
➜ testgit git:(master) ✗ git cat-file -p 8bae
abc
commit¶
当我们进行一次提交操作之后,就会产生两种类型的对象,一个是tree对象稍后再说,另一个就是commit对象。它的内容包括:
➜ testgit git:(master) ✗ git commit -m "first commit"
[master (root-commit) 37b766f] first commit
1 file changed, 1 insertion(+)
create mode 100644 test.txt
➜ testgit git:(master) tree .git/objects/
.git/objects/
├── 37
│ └── b766ff8084b9ea2e9a159bdb35b286a3406d3e
├── 8b
│ └── aef1b4abc478178b004d62031cf7fe6db6f903
├── 93
│ └── 4a610d6024005decae12f6ec4c242caa2a4de4
├── info
└── pack
5 directories, 3 files
➜ testgit git:(master) git cat-file -p 37b7
tree 934a610d6024005decae12f6ec4c242caa2a4de4
author hjlarry <hjlarry@163.com> 1582182460 +0800
committer hjlarry <hjlarry@163.com> 1582182460 +0800
first commit
cherry-pick
加入我们的分支,这时committer是我们自己,author仍然是别人。这里author需要包含username、email(所以刚使用git时要求在gitconfig中设置用户名和邮箱)、时间戳。紧跟着是提交的message。
实际上完整的commit对象的内容正是邮件的一种简单的格式,源于RFC2822。还包括一个parent,指向本次提交的父commit对象的路径地址,因为现在是第一次提交,没有parent。以及一个gpgsig,通过PGP签名了一下这个对象,通过cat-file
看不到。
也就是说我们通过git log
查看提交日志的信息,就是一层层的递归查看父对象拿到的。
tree¶
树对象解决的是文件名保存的问题,并能够将多个文件组织到一起。我们新建一次提交,添加更多内容为例:
➜ testgit git:(master) echo 'abcdef' > test.txt
➜ testgit git:(master) ✗ mkdir adir
➜ testgit git:(master) ✗ echo '123' > adir/tt.txt
➜ testgit git:(master) ✗ git add .
➜ testgit git:(master) ✗ git commit -m "third commit"
[master 79380b0] third commit
2 files changed, 2 insertions(+), 1 deletion(-)
create mode 100644 adir/tt.txt
➜ testgit git:(master) git cat-file -p 1bc4
040000 tree f1af0a5ebfe47de9d2d6db753088462b797b2075 adir
100644 blob 0373d9336f8c8ee90faff225de842888e884a48b test.txt
➜ testgit git:(master) git cat-file -p f1af
100644 blob 190a18037c64c43e6b11489df4bf0b9eb6d2c9bf tt.txt
也就是说,当我们通过git add *
时会把工作区文件的文件内容生成一个blob object,并把文件名和blob的sha1等其他信息更新到暂存区的index文件中;当我们通过git commit -m
时,git会根据index信息生成一个tree object,并创建一个新的commit object关联到这个tree。commit object的parent指向了上一个commit,当前分支的指针也会移动到新的commit结点。
tag¶
git中还有一种对象类型就是tag,它通常和commit差不多。见下文标签引用。
引用¶
引用本质上就是指向某个commit的指针,它被放在.gits/refs
目录中。
➜ testgit git:(master) tree .git/refs/
.git/refs/
├── heads
│ └── master
└── tags
2 directories, 1 file
➜ testgit git:(master) cat .git/refs/heads/master
79380b0625150b1b71940cfac0b2a501793eac0c
references = map<string, string>
def update_ref(name, id):
references[name] = id
def read_ref(name):
return references[name]
def load_ref(name_or_id):
if name_or_id in references: # 说明是name
return load(references[name_or_id])
else: # 说明是id
return load(name_or_id)
分支引用¶
当我们新建一个分支时,就会在.git/refs/heads
文件夹下多一个名称为分支名称的文件,内容就是一个commit的sha。当我们提交一次commit时,当前分支的引用的commit就会自动发生改变。
➜ testgit git:(6c27f42) git branch testbranch
➜ testgit git:(testbranch) cat .git/refs/heads/testbranch
6c27f425aae198e6c1e5098c13d352b3f27edfca
HEAD引用¶
它是一个符号引用,指向当前所在的分支。它位于.git/HEAD
文件。
➜ testgit git:(master) cat .git/HEAD
ref: refs/heads/master
➜ testgit git:(master) git checkout 6c27
Note: checking out '6c27'.
You are in 'detached HEAD' state.
➜ testgit git:(6c27f42) cat .git/HEAD
6c27f425aae198e6c1e5098c13d352b3f27edfca
标签引用¶
我们通常创建的都是轻量级标签,它只是一个引用,位于.gits/refs/tags
文件夹下。但还可以创建另一种附注标签,它会额外创建一个tag object。
➜ testgit git:(testbranch) git tag testmytag
➜ testgit git:(testbranch) cat .git/refs/tags/testmytag
6c27f425aae198e6c1e5098c13d352b3f27edfca
➜ testgit git:(testbranch) git tag -a v1.0 -m "test my tag"
➜ testgit git:(testbranch) cat .git/refs/tags/v1.0
0ee17848727b21f3086760c6bbc38cc9a12b5e08
➜ testgit git:(testbranch) git cat-file -t 0ee1
tag
➜ testgit git:(testbranch) git cat-file -p 0ee1
object 6c27f425aae198e6c1e5098c13d352b3f27edfca
type commit
tag v1.0
tagger hjlarry <hjlarry@163.com> 1582267013 +0800
test my tag
- 标签可以指向任意object,而分支只能指向commit object。
- 分支在每次提交更新时会自动更新,而标签不会。
远程引用¶
当我们添加一个远程仓库,或者是从远程库clone过来时,就会有远程引用,它位于.git/refs/remotes
文件夹下。
➜ testgit git:(testbranch) tree ~/my_git/.git/refs/remotes
/home/hejl/my_git/.git/refs/remotes
└── origin
├── HEAD
└── master
1 directory, 2 files
➜ testgit git:(testbranch) cat ~/my_git/.git/refs/remotes/origin/HEAD
ref: refs/remotes/origin/master
➜ testgit git:(testbranch) cat ~/my_git/.git/refs/remotes/origin/master
94985c6535a5493d493ce89631c7e417f5e7ecaa
常用操作¶
合并¶
FAST-FORWARD¶
当试图合并两个分支时,如果顺着一个分支一路走下去能到达另一个分支,那么Git的合并只是把指针往前推进,所以叫快进模式(即Fast-forward)。
➜ testgit git:(master) ✗ git checkout -b fixbug
Switched to a new branch 'fixbug'
➜ testgit git:(fixbug) ✗ echo '123' > test.txt
➜ testgit git:(fixbug) ✗ git add .
➜ testgit git:(fixbug) ✗ git commit -m "9th commit"
[fixbug 22a449d] 9th commit
1 file changed, 1 insertion(+)
➜ testgit git:(fixbug) git checkout master
Switched to branch 'master'
➜ testgit git:(master) git merge fixbug
Updating c658c0b..22a449d
Fast-forward
test.txt | 1 +
1 file changed, 1 insertion(+)
另外,我们往往会把远程仓库的更新git pull
下来,这背后实际上执行了两条指令,先git fetch
再git merge
,这种情况一般也属于Fast-forward合并。
三方合并¶
非FAST-FORWARD情况时,就是一次三方合并。三方指的是当前分支节点、要合并的分支的节点以及它们的共同祖父节点。这种情况会把它们的内容合并起来,如果没有冲突的话会自动形成一个新的commit。
➜ testgit git:(master) git checkout -b newfeature HEAD~2
Switched to a new branch 'newfeature'
➜ testgit git:(newfeature) echo 'newfeature' > newfeature.txt
➜ testgit git:(newfeature) ✗ git add .
➜ testgit git:(newfeature) ✗ git commit -m "add new feature"
[newfeature 68212fe] add new feature
1 file changed, 1 insertion(+)
create mode 100644 newfeature.txt
➜ testgit git:(newfeature) git checkout master
Switched to branch 'master'
➜ testgit git:(master) git merge newfeature
Merge made by the 'recursive' strategy.
newfeature.txt | 1 +
1 file changed, 1 insertion(+)
create mode 100644 newfeature.txt
git log --graph
可以观察到日志:
* commit 979309d67d62bd2fb3beeb009c20f750d362e93a (HEAD -> master)
|\ Merge: 22a449d 68212fe
| | Author: hjlarry <hjlarry@163.com>
| | Date: Sun Feb 23 21:46:55 2020 +0800
| |
| | Merge branch 'newfeature'
| |
| * commit 68212fef9f5e17091bcd14b4d9be713bfc2c763b (newfeature)
| | Author: hjlarry <hjlarry@163.com>
| | Date: Sun Feb 23 21:46:34 2020 +0800
| |
| | add new feature
| |
* | commit 22a449d52fe269ed7c969c179c1788f89013ac2d
| | Author: hjlarry <hjlarry@163.com>
| | Date: Sun Feb 23 21:39:01 2020 +0800
| |
| | 9th commit
| |
* | commit c658c0b8070ec1ab7dfe53351b64da79ae939e6d
|/ Author: hjlarry <hjlarry@163.com>
| Date: Sun Feb 23 16:57:12 2020 +0800
|
| 8th commit
➜ testgit git:(master) git cat-file -p 9793
tree 88cab0838dc7d8ae476592dbd60b4bda86dafbd8
parent 22a449d52fe269ed7c969c179c1788f89013ac2d
parent 68212fef9f5e17091bcd14b4d9be713bfc2c763b
author hjlarry <hjlarry@163.com> 1582465615 +0800
committer hjlarry <hjlarry@163.com> 1582465615 +0800
Merge branch 'newfeature'
三方合并时,也经常会遇到发生冲突的情况。这时候git会暂停合并,给出提示,并在冲突的地方做出标记。我们需要手工处理,选择某个分支或者自行再做修改都可以,然后再自行git add
和git commit
即可。
变基¶
基于之前三方合并的示例,还有一种合并分支的方法就是变基。它会在当前分支上重演一遍目标分支的历史,最后形成一个线性的提交历史。当前分支的commit object由于变更了其parent就会发生改变,而目标分支的commit object往往不会改变。
➜ testgit git:(master) git checkout -b testrebase HEAD~
Switched to a new branch 'testrebase'
➜ testgit git:(testrebase) echo 'testrebase'>test.txt
➜ testgit git:(testrebase) ✗ git add .
➜ testgit git:(testrebase) ✗ git commit -m "test rebase"
[testrebase 7f4088a] test rebase
1 file changed, 1 insertion(+), 3 deletions(-)
➜ testgit git:(testrebase) git checkout master
Switched to branch 'master'
➜ testgit git:(master) git log --graph
➜ testgit git:(master) git rebase testrebase
First, rewinding head to replay your work on top of it...
Applying: add new feature
* commit cd2c246f0cfcd2d98717af0a405ac17fd23636bc (HEAD -> master)
| Author: hjlarry <hjlarry@163.com>
| Date: Sun Feb 23 21:46:34 2020 +0800
|
| add new feature
|
* commit 7f4088a0254081c4349a253c2d3a74dd7a7f1234 (testrebase)
| Author: hjlarry <hjlarry@163.com>
| Date: Sun Feb 23 22:47:17 2020 +0800
|
| test rebase
|
* commit 22a449d52fe269ed7c969c179c1788f89013ac2d (fixbug)
| Author: hjlarry <hjlarry@163.com>
| Date: Sun Feb 23 21:39:01 2020 +0800
|
| 9th commit
|
* commit c658c0b8070ec1ab7dfe53351b64da79ae939e6d
| Author: hjlarry <hjlarry@163.com>
| Date: Sun Feb 23 16:57:12 2020 +0800
|
| 8th commit
它典型的使用场景,例如团队其他人维护的项目,我们在自己的分支上为其提供feature,然后把我们的分支变基到origin/master上,这样其他人只需要去FAST-FORWARD而无需人工整合。
交互式变基¶
通过git rebase -i <commit_id>
就能进入一个交互式界面:
pick 2c70e0b second commit a
pick c351a72 third commit
# Rebase 37b766f..c351a72 onto 37b766f (2 commands)
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
# d, drop = remove commit
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out
commit_id
(可以用commit的hash或者HEAD~3
这样的形式)的child一直到当前分支的最后一个commit,我们可以在这个界面中编辑想对每一个commit做的操作:
- p,对这条commit不做任何变更
- r,使用这条commit,但修改它的commit message
- e,先暂停rebase,把这条commit修改编辑以后再继续,继续时使用
git rebase --continue
即可 - s,使用这条commit,但把它合并入前一条commit
- f, 和s相同,但丢弃掉它的commit message
- x, 在rebase过程中执行一些命令,例如
npm test
之类确保修改不会产生破坏性内容 - d, 移除这条commit
我们在一些场景,例如修改老旧commit的msg、把连续或间隔的多个commit整理为1个等使用交互式变基都会比较方便。
这种方式看起来没有办法修改最祖先的那条commit,实际上有这种场景时我们可以直接把祖先commit添加到头部即可。在交互式界面中也可以手动调整commit的顺序。有些操作例如修改commit msg,就会产生一个新的commit object,当然也会影响到它的所有child object,因为sha值变了,就得一层层的修改下去。
常用命令¶
命令 | 意义 |
---|---|
git diff |
比较工作区和暂存区所含文件的差异 |
git diff HEAD |
比较工作区和HEAD所含文件的差异 |
git diff --cached |
比较暂存区和HEAD所含文件的差异 |
git diff -- <file> |
比较工作区和HEAD某个文件的差异 |
git reset HEAD |
暂存区的所有文件恢复的和HEAD一样 |
git reset HEAD <file> |
暂存区某个文件恢复为HEAD那个文件 |
git checkout -- <file> |
工作区某个文件恢复为暂存区那个文件 |
git reset --hard <commit> |
工作区恢复为该commit,回滚和未来均可 |
git stash |
暂存工作现场 |
git stash apply |
恢复工作现场 |
git stash apply <index> |
恢复到某个工作现场 |
git branch -av |
查看所有本地和远程的分支及其对应的commit |
git checkout -b <name> <commit> |
创建一个分支并切换过去,commit可省略 |
git branch -f <name> <commit> |
强制把某个分支移动到commit处去 |
git branch -u origin/A |
将本地当前分支和远程A分支关联 |
其他技巧¶
cherry-pick¶
cherry-pick类似于一个定制化的merge,它可以把其它分支上的commit一个个摘下来,合并到当前分支。
它的使用方法是git cherry-pick <commid_id1> <commid_id2> ...
,就会把每个挑选的commit提交一次生成一个新的commit id。也可以通过git cherry-pick -n <commid_id1> <commid_id2>
挑选出相应的commit至暂存区而不提交,后续自己可以再手动提交。
reflog¶
引用日志记录了用户在本地更改的完整历史记录,通过git reflog
可以查看到类似这样的信息
e1b4a61 (HEAD) HEAD@{0}: revert: Revert "8th commit"
979309d HEAD@{1}: checkout: moving from master to HEAD@{11}
c658c0b (master) HEAD@{2}: reset: moving to c658
5665150 HEAD@{3}: reset: moving to 5665
...
HEAD@{0} 撤销操作: 撤销的消息
HEAD@{1} 切换操作: 从master切换至HEAD@{11}
HEAD@{2} 重置操作: 重置至c658
HEAD@{3} 重置操作: 重置至5665
git checkout HEAD@{1}
这样的操作恢复到切换操作时的场景。
submodule¶
使用场景,例如开发过程中有一些通用的部分希望抽出作为一个公共的库来维护,或者hugo中的某些皮肤也使用了submodule。
包含子模块的项目,在clone主项目的时候需要带参数git clone <url> --recurse-submodules
或者使用git submodule init && git submodule update
。
如果子模块的内容我们做了变更,在主模块中使用git add/commit
是无效的。如果子模块的远程仓库有更新,我们也需要进入子模块文件夹才能获取到更新。
工作流¶
工作流(workflow)是指在多人协作的时候,团队以什么样的工作流程有效的合作。
Git Flow¶
该工作流为项目设定了两个长期分支,即主分支master和开发分支develop。master存放了对外发布的版本,任何时候在这个上面拿到的都是稳定的发布版。develop用于日常开发,存放最新的开发版本。
其次,项目根据不同的目的设定了三个短期分支,包括功能分支(feature branch)、补丁分支(hotfix branch)和预发分支(release branch)。一旦完成相应的开发,短期分支被合并入develop或master,然后删除该短期分支。
这种工作流程使用起来会比较麻烦,因为维护了两个长期分支,可能需要经常切换。它比较适合软件项目,而不是网站项目,因为大多数网站是持续发布的,一有代码变动可能就会更新一次,这时候往往master和develop分支的区别不大,也就没有必要同时维护两套了。
Github Flow¶
这套工作流程在Git Flow上做了简化,只有一个长期分支master,适合于持续发布的场景,是github官方使用的工作流程,它们也做了相关的介绍。其具体流程是这样的:
- 你从master中拉出新分支,不区分是功能还是补丁
- 新分支开发完成后,就向master发起一个PR
- PR会让其他人注意到你的请求,也是一种对话机制,让大家都能来参与评审你的代码,对话过程中也可以不断提交代码
- 你的PR被接受并入master中,原本你拉出来的分支就会被删除
这种流程也有一个问题,它假设master分支和产品的发布是一致的。这在一些场景,例如苹果Appstore的发布可能因为审核要延迟,或有些产品是要指定时间发布的,一个master分支就显得不够了。
Gitlab Flow¶
Gitlab结合了Git flow和Github flow的优点,既能适应不同开发环境的弹性,又仍然只需维护单一分支,官网也有相关介绍。
它定义了一个原则即上游优先,只存在一个主分支master,它是其他分支的上游。只有上游分支变化了,才能应用到其他的分支。
对于需要持续发布的项目,它建议在master之外,再根据不同的环境建立分支。例如开发环境定义为master是最上游,预开发环境定义为pre-production是开发环境的下游,生产环境定义为production是最下游。那么当生产环境出了bug,就要新建一个功能分支,先把它合并入master,确认没问题再cherry-pick至预开发环境,最终再进入生产环境。只有紧急情况才允许跳过上游直接并入下游。
对于需要按版本发布的项目,建议的做法是每一个版本都要从master中拉出一个分支来,如2-3-stable
。之后只有修补bug才允许将代码合并入这些分支,更新相应的小版本号。
FAQ¶
每次commit,Git储存的是全新的文件快照还是储存文件的变更部分?
Git储存的是全新的文件快照,即使你只修改了文件的一行,也会产生一个新的blob对象。这种储存方式存储的对象格式被称为松散(loose)格式。
这样势必会造成大量的空间浪费。但是,Git会时不时的把这些松散格式的文件打包成一个称为包文件(packfile)的二进制文件以节省空间和提升效率。手动执行git gc
也可以达到这种效果。这也是./git/objects/info
和./git/objects/pack
两个文件夹的用途。
为什么要有暂存区的概念,不能直接存储么?
因为提交是需要原子性的,即一次提交下的文件,要么全部成功,要么全部失败。
但在Git的命令行下,我们很难像SVN那样有一个图形界面,勾选要提交的文件,填入提交信息,点个按钮就能完成提交。需要git add
这个命令帮助我们选择要提交的文件。
使用merge还是rebase合并分支?
git merge
和git rebase
都被设计来将一个分支的更改并入另一个分支,但它们的方式却不太一样。
merge是一个安全的操作,现有的分支不会被更改。但另一方面,每次合并一个feature分支时都会引入一个外来的合并提交,当同时进行的feature过多时会使得整个树看起来非常杂乱,增加了开发者了解项目历史的成本。
rebase最大的好处就是使项目的历史非常的整洁、线性,可以从项目的起点开始浏览到终点不需要任何的分叉。但是不合理的rebase会给团队其他人协同开发带来很大的困扰。此外,rebase不能在合并提交时附带message,也就不能像merge那样看到feature分支的并入带来了哪些更改。
所在,绝不能在公共的分支使用变基,也不能使用git push -f
强制推送去修改远程仓库的历史。合理的使用场景应该像下面描述的这样:
基于上游分支master拉出来一个dev的分支,自行在dev上开发完成后可能master已经有了其他人开发的新的内容,这时应该在dev分支上使用git rebase master
把master分支的内容先同步过来,然后在master分支上使用git merge dev
把dev分支的内容放回去。
此外,一般有远程仓库,那么相应的可能是通过git pull --rebase
把远程的变更内容拿回来,然后通过PR的方式由远程仓库的管理者决定如何并入远程分支。
使用revert、reset还是checkout回滚代码?
代码的回滚可以分为回滚某次提交,或者回滚某些文件两个层面。
对于回滚提交,应该使用reset和revert。
reset的本质是把HEAD移动到某个commit的位置,那么该分支从新HEAD到末端的这部分就处于悬挂状态,如果上面没有什么tag或branch引用的话,再下次git进行垃圾回收的时候就会被删除。reset本身有参数,--mixed
为默认选项,表示暂存区和将要reset的提交同步,而工作区不受影响;使用--hard
表示暂存区和工作区都和将要reset的提交同步;使用--soft
表示暂存区和工作区都不做改变。
而revert是不会改变提交的历史的,它会创建一个新的提交,而这个提交的内容是撤回的部分。所以revert往往用于公共的分支上。
对于文件提交,应该使用reset和checkout。区别在于checkout用于把工作区中的某个文件恢复为某个commit中的该文件,而reset用于把暂存区中的某个文件恢复至某个commit的该文件,--mixed
、--soft
、--hard
对于恢复文件的场景是无效的参数。