公共服务平台网站建设方案,佛山网站建设费用预算,wordpress编辑网站,大厂县住房和城乡建设局网站文章目录 Gitignore文件使用描述Gitignore基本语法1. 基本语法★★★★★2. 配置方法 匹配示例示例1示例2示例3 其他命令git status --ignored#xff08;用于显示被Git忽略的文件和文件夹的状态#xff09;git check-ignore -v file#xff08;用于检查指定文件是否… 文章目录 Gitignore文件使用描述Gitignore基本语法1. 基本语法★★★★★2. 配置方法 匹配示例示例1示例2示例3 其他命令git status --ignored用于显示被Git忽略的文件和文件夹的状态git check-ignore -v file用于检查指定文件是否被Git忽略并显示忽略规则的详细信息 答疑关于“否定模式!中被先前模式排除的任何匹配文件将重新包含。如果排除了文件的父目录则无法重新包含该文件”如何取消已跟踪的文件示例 参考文章 Gitignore文件
Gitignore是一个用于指定Git版本控制系统忽略特定文件或目录的规则文件。它的发展可以追溯到早期的版本控制系统如CVS和SVN这些系统使用类似的机制来忽略特定文件。
在Git中Gitignore文件的原理是通过定义一系列规则来告诉Git哪些文件应该被忽略。这些规则可以是简单的通配符模式也可以是正则表达式。当Git执行某个操作时如添加文件到版本控制或提交更改它会检查Gitignore文件中的规则并根据规则来决定是否忽略某个文件。
Gitignore文件的作用是帮助开发者过滤掉不需要被版本控制的文件以减少仓库的体积和提高操作效率。它可以用于忽略一些临时文件、编译生成的文件、日志文件、配置文件等。通过忽略这些文件可以使版本控制系统更加干净和专注于源代码的管理。
使用描述
一个.gitignore文件指定了Git应该忽略的意图上未跟踪的文件。已经被Git跟踪的文件不受影响有关详细信息请参阅下面的注释。
gitignore文件中的每一行都指定了一个模式。在决定是否忽略一个路径时Git通常会从多个来源检查gitignore模式按照以下优先顺序在一个优先级级别内最后匹配的模式决定结果
对于支持它们的命令从命令行读取的模式。
从与路径相同目录中的.gitignore文件或者从任何父目录直到工作树的顶级中读取的模式其中较高级别文件中的模式会被较低级别文件中的模式覆盖直到包含该文件的目录。这些模式相对于.gitignore文件的位置进行匹配。一个项目通常会在其存储库中包含这样的.gitignore文件其中包含作为项目构建的一部分生成的文件的模式。
从$GIT_DIR/info/exclude中读取的模式。
从由配置变量core.excludesFile指定的文件中读取的模式。
将模式放在哪个文件中取决于模式的使用方式。
应该进行版本控制并通过克隆分发到其他存储库即所有开发人员都希望忽略的文件的模式应该放在.gitignore文件中。
特定于特定存储库但不需要与其他相关存储库共享的模式例如存储库内部但特定于一个用户工作流程的辅助文件应该放在$GIT_DIR/info/exclude文件中。
用户希望Git在所有情况下都忽略的模式例如用户选择的编辑器生成的备份或临时文件通常放在由core.excludesFile在用户的~/.gitconfig中指定的文件中。它的默认值是$XDG_CONFIG_HOME/git/ignore。如果$XDG_CONFIG_HOME未设置或为空则使用$HOME/.config/git/ignore。
底层的Git工具如git ls-files和git read-tree从命令行选项指定的gitignore模式或从命令行选项指定的文件中读取。更高级别的Git工具如git status和git add使用上述来源中的模式。
Gitignore基本语法
Gitignore文件的基本使用方法是通过定义规则来告诉Git哪些文件应该被忽略。下面是Gitignore文件的基本语法和配置方法
1. 基本语法★★★★★
空行不匹配任何文件因此可以用作可读性的分隔符。以“#”开头的行作为注释。对于以“#”开头的模式可以在第一个“#”前面加上反斜杠“\”。尾随空格会被忽略除非用反斜杠“\”引用。可选的前缀“!”可以否定模式被先前模式排除的任何匹配文件将重新包含。如果排除了文件的父目录则无法重新包含该文件。出于性能原因Git不会列出被排除的目录因此对包含的文件的任何模式都没有影响无论它们在何处定义。对于以字面“!”开头的模式例如“\!important!.txt”可以在第一个“!”前面加上反斜杠“\”。斜杠“/”用作目录分隔符。分隔符可以出现在.gitignore搜索模式的开头、中间或结尾。如果模式的开头或中间或两者都有有分隔符/则该模式相对于特定.gitignore文件所在的目录级别。否则该模式也可以在.gitignore级别以下的任何级别匹配。比如a/b中间有斜杠需要a与.gitignore同级才会被匹配c/a/b不会匹配/a同样如果模式的结尾有分隔符/则该模式只匹配目录否则该模式可以匹配文件和目录。例如模式doc/frotz/匹配doc/frotz目录但不匹配a/doc/frotz目录但是frotz/匹配frotz和a/frotz这两个目录所有路径都是相对于.gitignore文件的。星号“*”匹配除斜杠以外的任何字符可匹配多个字符组成的字符串但字符串中不能包含斜杠/。问号“?”匹配除斜杠以外的任何一个字符只能匹配一个字符。范围表示法例如[a-zA-Z]可用于匹配范围内的一个字符。有关更详细的说明请参阅fnmatch(3)和FNM_PATHNAME标志。在与完整路径名匹配的模式中两个连续的星号“**”可能具有特殊含义 以“**”开头的斜杠表示在所有目录中匹配。例如“**/foo”匹配任何位置的文件或目录“foo”与模式“foo”相同。“**/foo/bar”匹配直接位于目录“foo”下的文件或目录“bar”。以“/**”结尾的斜杠表示匹配其中的所有内容。例如“abc/**”匹配相对于.gitignore文件位置的目录“abc”中的所有文件具有无限深度。斜杠后面跟着两个连续的星号然后是斜杠表示匹配零个或多个目录。例如“a/**/b”匹配“a/b”、“a/x/b”、“a/x/y/b”等。 其他连续的星号被视为普通的星号并根据前面的规则进行匹配。
2. 配置方法
在项目根目录下创建一个名为.gitignore的文件。在.gitignore文件中添加需要忽略的文件或目录的规则。每行一个规则可以使用上述基本语法来定义规则。保存.gitignore文件。
对于有多个目录的情况想要忽略某种类型文件的目录和不想忽略的目录可以在.gitignore文件中分别定义规则。例如假设有两个目录dir1和dir2想要忽略dir1目录下的.txt文件但不想忽略dir2目录下的.txt文件可以按照以下步骤进行配置 在.gitignore文件中添加以下规则 # 忽略dir1目录下的.txt文件
/dir1/*.txt在dir2目录下创建一个名为.gitignore的文件。 在dir2/.gitignore文件中添加以下规则 # 不忽略dir2目录下的.txt文件
!*.txt这样配置后Git会忽略dir1目录下的.txt文件但不会忽略dir2目录下的.txt文件。注意.gitignore文件的规则是逐级生效的所以在dir2/.gitignore文件中使用!*.txt来取反表示不忽略dir2目录下的.txt文件。
匹配示例
示例1
模式 hello.* 匹配以 hello. 开头的任何文件或目录。如果只想限制在目录中而不包括其子目录可以在模式前加上斜杠即 /hello.*现在模式匹配 hello.txt、hello.c但不匹配 a/hello.java。
模式 foo/ 匹配目录 foo 及其下面的路径但不匹配普通文件或符号链接 foo这与 Git 中 pathspec 的工作方式一致。
模式 doc/frotz 和 /doc/frotz 在任何 .gitignore 文件中具有相同的效果。换句话说如果模式中已经有中间斜杠那么前导斜杠就不相关了。
模式 “foo/*” 匹配 “foo/test.json”普通文件、“foo/bar”目录但不匹配 “foo/bar/hello.c”普通文件因为模式中的星号不匹配带有斜杠的 “bar/hello.c”。
$ git status
[...]
# Untracked files:
[...]
# Documentation/foo.html
# Documentation/gitignore.html
# file.o
# lib.a
# src/internal.o
[...]
$ cat .git/info/exclude
# ignore objects and archives, anywhere in the tree.
*.[oa]
$ cat Documentation/.gitignore
# ignore generated html files,
*.html
# except foo.html which is maintained by hand
!foo.html
$ git status
[...]
# Untracked files:
[...]
# Documentation/foo.html
[...]上面这段代码是一个示例用来说明git中的文件忽略功能。在这个示例中首先使用git status命令查看当前仓库的状态发现有一些未跟踪的文件。然后通过查看.git/info/exclude文件和Documentation/.gitignore文件可以看到哪些文件被设置为忽略。最后再次使用git status命令查看仓库的状态发现只有Documentation/foo.html文件没有被忽略。
示例2
$ cat .gitignore
vmlinux*
$ ls arch/foo/kernel/vm*
arch/foo/kernel/vmlinux.lds.S
$ echo !/vmlinux* arch/foo/kernel/.gitignore第二个 .gitignore 防止 Git 忽略 arch/foo/kernel/vmlinux.lds.S。
示例3
例子排除除了特定目录 foo/bar 之外的所有内容注意 /* - 如果没有斜杠通配符也会排除 foo/bar 内的所有内容
$ cat .gitignore
# 排除除了目录 foo/bar 之外的所有内容
/*
!/foo
/foo/*
!/foo/bar其他命令
git status --ignored用于显示被Git忽略的文件和文件夹的状态
git status --ignored命令用于显示被Git忽略的文件和文件夹的状态。
Git有一个名为.gitignore的文件用于指定哪些文件和文件夹应该被忽略不纳入版本控制。这些被忽略的文件和文件夹不会出现在git status命令的输出中。
然而有时候我们可能想要查看被忽略的文件和文件夹的状态以确保我们的.gitignore文件配置正确。这时就可以使用git status --ignored命令。
以下是一个示例输出
On branch master
Your branch is up to date with origin/master.Changes not staged for commit:(use git add file... to update what will be committed)(use git restore file... to discard changes in working directory)modified: index.htmlIgnored files:(use git add -f file... to include in what will be committed)ignored_file.txtignored_folder/no changes added to commit (use git add and/or git commit -a)在上面的示例中index.html文件被修改但未暂存而ignored_file.txt和ignored_folder/被.gitignore文件忽略。
git check-ignore -v file用于检查指定文件是否被Git忽略并显示忽略规则的详细信息
git check-ignore -v file命令用于检查指定文件是否被Git忽略并显示忽略规则的详细信息。
当我们在使用.gitignore文件或其他忽略规则时有时候我们想要验证某个文件是否被正确地忽略。这时就可以使用git check-ignore -v file命令。
以下是一个示例输出
.gitignore:3:ignored_file.txt ignored_file.txt在上面的示例中.gitignore文件的第3行规则忽略了ignored_file.txt文件并且git check-ignore -v命令显示了这个信息。
如果文件没有被忽略那么该命令将不会有任何输出。
这个命令对于调试和验证忽略规则非常有用可以帮助我们确保文件被正确地忽略。
答疑
关于“否定模式!中被先前模式排除的任何匹配文件将重新包含。如果排除了文件的父目录则无法重新包含该文件”
看一个示例
我的/test/test/中有a.txt和b.txt两个文件/test/test/与.gitignore同级
模式1
/*
!/test/test/
# !/test/
/test/test/*
!/test/test/a.txt结果 模式2
/*
# !/test/test/
!/test/
/test/test/*
!/test/test/a.txt结果 就是说在这个示例中用/*排除了所有文件后如果想恢复一个目录或者目录中的文件一定要先恢复与/*同级下的这个目录或文件的最终父目录在这个示例中是/test/目录可以看到恢复/test/test/是没有效果的。
如何取消已跟踪的文件
比如已经有一些大文件已经被跟踪了但是我们不想跟踪了想在下一次提交的时候排除掉怎么办
可以用
git rm --cached 文件名/目录或者用通配符
git rm --cached *.txt或者用递归目录方式
git rm --cached -r 文件夹路径示例
执行git rm --cached *.tar取消所有.tar文件的跟踪 在.gitignore中增加一个*.tar 执行git status --ignored查看发现文件被取消跟踪了那我们下次提交的时候就不会把这些二文件提交上去了 参考文章
https://git-scm.com/docs/gitignore
.gitignore文件作用及使用方法详解
Git – Ignore命令
