Git的gitattributes文件详解

约定不等于承诺〃 2022-06-06 12:30 227阅读 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 条评论，227人围观）

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

相关阅读

相关 Git（二）：Git 过滤文件（1）——.gitattributes

Windows-specific files that require CRLF: .bat eol=crlf .txt eo

亦凉/ 2023年05月29日 02:22/ 0 赞/ 22 阅读

相关 git之.gitignore文件详解

参考：[git-book][] 一般我们总会有些文件无需纳入 Git 的管理，也不希望它们总出现在未跟踪文件列表。通常都是些自动生成的文件，比如日志文件，或者编译过程中创

太过爱你忘了你带给我的痛/ 2023年03月01日 09:44/ 0 赞/ 27 阅读

相关 git--详解

原文网址：[git--详解\_IT利刃出鞘的博客-CSDN博客][git--_IT_-CSDN] HEAD 简介 > git 是通过HEAD来确定你当前在哪个分支上工

向右看齐/ 2023年02月25日 02:15/ 0 赞/ 18 阅读

相关 .gitattributes 作用详细讲解（git大佬必会技能)

git 的隐藏文件 `.gitattributes` 本文以 Spring 在 github 中的代码为例，介绍 git 的几个隐藏文件的作用、写法、含义。文章目录

水深无声/ 2023年02月19日 15:22/ 0 赞/ 25 阅读

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

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

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

相关 Git详解

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

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

相关 Git的gitattributes文件详解

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

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

相关 [转载]通过阅读 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 赞/ 360 阅读

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

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

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

相关 Git忽略文件.gitignore详解

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

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