名称

gitignore  - 指定忽略有意未被跟踪的文件

概要

$HOME/.config/git/ignore, $GIT_DIR/info/exclude, .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，使用来自上面指定源的模式。模式格式

• 空白行不匹配任何文件，因此它可以作为可读性的分隔符。

• 以 ＃ 开始的行作为评论。将\第一个散列前面的反斜杠（“ ”）放在以散列开头的模式中。

• 尾部空格被忽略，除非用反斜杠（“ \”）引用。

• 可选的前缀“ !”，否定模式; 任何先前模式排除的匹配文件将再次包含在内。如果排除该文件的父目录，则不可能重新包含文件。由于性能原因，Git 没有列出排除的目录，因此无论它们被定义在何处，包含文件的任何模式都不起作用。将反斜杠（“ \”）放在第一个“ !”之前，以“ !” 开头的模式，例如“ \!important!.txt”。

• 如果模式以斜杠结尾，则为了以下描述的目的将其删除，但它只会与目录找到匹配项。换句话说，foo/它将匹配一个目录foo和它下面的路径，但不匹配一个常规文件或符号链接foo（这与在Git中通常如何工作的方式一致）。

• 如果模式不包含斜线/，则Git将其视为 shell glob 模式，并检查与.gitignore文件位置相关的路径名的匹配（相对于工作树的顶层，如果不是来自.gitignore文件）。

• 否则，Git 将该模式视为适合 fnmatch（3）使用 FNM_PATHNAME 标志使用的 shell glob：模式中的通配符不会与路径名中的/匹配。例如，“Documentation / *。html” 与 “Documentation / git.html” 匹配，但不匹配 “Documentation / ppc / ppc.html” 或 “tools / perf / Documentation / perf.html”。

• 前导斜杠匹配路径名的开头。例如，“/*.c” 与 “cat-file.c” 匹配，但不匹配 “mozilla-sha1 / sha1.c” **。匹配完整路径名的模式中的两个连续星号（“ ”）可能有特殊含义：

• 前面的“ **”后跟斜杠意味着所有目录匹配。例如，“ **/foo” foo在任何地方与文件或目录“ ”匹配，与模式“ foo” 相同。“ **/foo/bar”与bar直接在目录“ foo” 下的任何地方的文件或目录“ ”匹配。

• 尾随 “ /**” 匹配内部的所有内容。例如，“ abc/**” 匹配目录 “ abc” 内的所有文件，相对于.gitignore文件的位置，具有无限深度。

• 斜杠后跟两个连续的星号，则斜线匹配零个或多个目录。例如，“ a/**/b” 匹配“ a/b”，“ a/x/b”，“ a/x/y/b” 等。

• 其他连续的星号被认为是无效的。

笔记

gitignore 文件的目的是确保未被 Git 跟踪的某些文件保持未被跟踪。

要停止跟踪当前跟踪的文件，请使用git rm --cached。

例子

    $ 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    [...]

另一个例子：

    $ 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。

示例排除除特定目录以外的所有内容foo/bar（请注意/*- 没有斜杠，通配符也会排除所有内容foo/bar）：

    $ cat .gitignore
    # exclude everything except directory foo/bar    /*
    !/foo
    /foo/*
    !/foo/bar