Git的gitattributes文件详解

约定不等于承诺〃 2022-06-06 12:30 188阅读 0赞

Git的gitattributes文件是一个文本文件，文件中的一行定义一个路径的若干个属性。

1. gitattributes文件以行为单位设置一个路径下所有文件的属性，格式如下：

要匹配的文件模式 属性1 属性2 ...

2. 在gitattributes文件的一行中，一个属性（以text属性为例）可能有4种状态：

*  设置text
 *  不设置-text
 *  设置值text=string
 *  未声明，通常不出现该属性即可；但是为了覆盖其他文件中的声明，也可以!text

3. gitattributes文件示例：

*               text=auto
    *.txt		text
    *.jpg		-text
    *.vcproj	text eol=crlf
    *.sh		text eol=lf
    *.py		eol=lf

说明：

第1行，对任何文件，设置text=auto，表示文件的行尾自动转换。如果是文本文件，则在文件入Git库时，行尾自动转换为LF。如果已经在入Git库中的文件的行尾为CRLF，则该文件在入Git库时，不再转换为LF。

第2行，对于txt文件，标记为文本文件，并进行行尾规范化。

第3行，对于jpg文件，标记为非文本文件，不进行任何的行尾转换。

第4行，对于vcproj文件，标记为文本文件，在文件入Git库时进行规范化，即行尾为LF。但是在检出到工作目录时，行尾自动转换为CRLF。

第5行，对于sh文件，标记为文本文件，在文件入Git库时进行规范化，即行尾为LF。在检出到工作目录时，行尾也不会转换为CRLF（即保持LF）。

第6行，对于py文件，只针对工作目录中的文件，行尾为LF。

4. 在一个Git库中可以有多个gitattributes文件：

*  不同gitattributes文件中，属性设置的优先级(从高到低)：

/myproj/info/attributes文件  
/myproj/my\_path/.gitattributes文件  
/myproj/.gitattributes文件

*  同一个gitattributes文件中，按照行的先后顺序，如果一个文件的某个属性被多次设置，则后序的设置优先

5. 也可以为所有Git库设置统一的gitattributes文件：

git config --get core.attributesFile
    git config --global --get core.attributesFile

6. gitattributes文件中可以定义的属性：

*  text，控制行尾的规范性。

如果一个文本文件是规范的，则Git库中该文件的行尾总是LF。

对于工作目录，除了text属性之外，还可以设置eol属性，或core.eol配置变量。

*  eol，设置行末字符
    
     *  eol=lf，入库时将行尾规范为LF，检出时禁止将行尾转换为CRLF
     *  eol=crlf，入库时将行尾规范为CRLF，检出时将行尾转换为CRLF
 *  crlf，已过时，类似于text
 *  ident，为路径设置ident属性，路径中的blob对象中的$Id$将会被替换为$Id:char\_40\_hexadecimal\_name
 *  filter

利用命令clean,smudge

*  diff
 *  merge，与merge.default配置变量一起确定如何合并文件

在执行git merge, git revert和git cherry-pick时，如何考虑文件的版本  
Git内置的merge驱动：

*   *  merge=text
     *  merge=binary
     *  merge=union
 *  whitespace，对应core.whitespace配置变量

在执行git diff, git apply时是否考虑空格。

*  export-ignore,export-subst，打包相关的属性
 *  delta，即Delta压缩

对于delta=false的路径中的blob对象，不会进行Delta压缩

*  encoding，为GUI工具（如gitk, git-gui）设置字符编码，以正确显示匹配的文件内容

如果该属性未设置，或设置了无效值，则GUI工具会使用配置变量gui.encoding的值。

参考链接：

https://git-scm.com/docs/gitattributes

发表评论取消回复

表情：

评论列表（有 0 条评论，188人围观）

还没有评论，来说两句吧...

相关阅读

相关 GIT的过滤文件

用GIT进行源代码管理，可以设置一个过滤名单，指明哪些文件夹、文件不进行提交和更新。这个文件就是 .gitignore，位于受GIT托管的项目的根目录下。当我们创建一...

一时失言乱红尘/ 2024年04月19日 15:52/ 0 赞/ 33 阅读

相关 Git一一IDEA使用Git的详解

参考目录 > 声明: 以下内容为转载,以便复习; [(详解)IDEA中使用git教程][IDEA_git] [IDEA中git远程版本回退][IDEA_gi

电玩女神/ 2023年07月13日 12:14/ 0 赞/ 88 阅读

相关 git 详解及 git 工具的使用

git 详解及 git 工具的使用一、版本控制系统简介本地版本控制系统集中式版本控制系统分布式版本控制系统二

淡淡的烟草味﹌/ 2023年02月11日 11:26/ 0 赞/ 151 阅读

相关 Git - .gitattributes - 学习/实践

1.应用场景 <table> <tbody> <tr> <td>主要用于Git版本管理中指定非文本文件的对比合并方式.</td> </tr> <

末蓝、/ 2022年11月25日 11:42/ 0 赞/ 192 阅读

相关 Git详解之一：Git起步

起步本章介绍开始使用 Git 前的相关知识。我们会先了解一些版本控制工具的历史背景，然后试着让 Git 在你的系统上跑起来，直到最后配置好，可以正常开始开发工作。读完本章，

忘是亡心i/ 2022年08月07日 17:30/ 0 赞/ 191 阅读

相关 Git详解

一、Git是什么（what）（一）概述 Git是分布式版本控制系统，与SVN类似的集中化版本控制系统相比，集中化版本控制系统如果中央服务器宕机则会影响数据和协同开

灰太狼/ 2022年06月06日 14:23/ 0 赞/ 141 阅读

相关 Git的gitattributes文件详解

Git的gitattributes文件是一个文本文件，文件中的一行定义一个路径的若干个属性。 1. gitattributes文件以行为单位设置一个路径下所有文件的属性，格式

约定不等于承诺〃/ 2022年06月06日 12:30/ 0 赞/ 189 阅读

相关 [转载]通过阅读 git-config 文档理解 Git 如何使用autocrlf、safecrlf、eol和.gitattributes处理line-ending

[原文链接：通过阅读 git-config 文档理解 Git 如何使用autocrlf、safecrlf、eol和.gitattributes处理line-ending][gi

ゞ浴缸里的玫瑰/ 2022年04月05日 10:13/ 0 赞/ 331 阅读

相关 Git .gitignore文件配置规则详解

规则作用 1. /mtk 过滤整个文件夹 2. \.zip 过滤所有.zip文件 3. /mtk/do.c 过滤某个具体文件 4. !/mtk/one.txt

桃扇骨/ 2021年06月22日 15:36/ 0 赞/ 512 阅读

相关 Git忽略文件.gitignore详解

文章目录 * Git 忽略规则优先级 Git 忽略规则匹配语法常用匹配示例 .gitignore规则不生效...

小灰灰/ 2020年06月13日 06:06/ 0 赞/ 910 阅读