Dealing with line endings (Windows)

如果你正在使用Git在GitHub上和别人协作的话,确保Git处理行结束符的配置已经正确配置了。

每次在键盘上按下return键时,实际上你正在插入一个称之为行结束符(line ending)的不可见字符。由于历史的原因,不同的操作系统处理行结束符的方式的不一样的。

当你查看一个文件的变更时,Git会以它自己的方式处理行结束符。因为你在项目中使用Git和GitHub进行协作,Git可能产生预料外的结果。比如你在Windows系统上工作,而你的协作者是在OS X上做的变更。

针对行结束符的全局设定

git config core.autocrlf命令被用来改变Git处理行结束符的方式。它接受一个单一的参数。

在Windows中,简单地传递true给这个配置。比如:

$ git config --global core.autocrlf true
# Configure Git on Windows to properly handle line endings

每个库的设定

你可以选择通过配置一个特殊的.gitattributes文件在每个库的基础上配置Git管理行结束符的方式。这个文件被提交给库并且覆盖一个各自的core.autocrlf设置,确保所有用户行为的一致性,而不管他们的Git设置。.gitattributes文件的优势是你的配置和你的库相关。你不需要担心你的协作者是否和你有相同的配置。

.gitattributes文件必须在库的根目录创建并像其他文件一下提交。

.gitattributes文件就像包含两列的表:

左边是给Git去匹配的文件名。

右边是Git将会用于文件的行结束符配置。

.gitattributes 文件例子,使用它作为你的库的模板:

# Set the default behavior, in case people don't have core.autocrlf set.
* text=auto # Explicitly declare text files you want to always be normalized and converted
# to native line endings on checkout.
*.c text
*.h text # Declare files that will always have CRLF line endings on checkout.
*.sln text eol=crlf # Denote all files that are truly binary and should not be modified.
*.png binary
*.jpg binary

你注意到文件被 *c,*.sln,*.png匹配,一个空格分割,然后是设置,text,text eof=crlf,binary。

下面是一些可能的设置:

text=auto Git以它认为最好的方式处理文件。这是个好的默认选项。

text eof=crlf 在checkout时,Git总是将文件结束符转换为CRLF。对于必须保留CRLF结尾的文件,即便是在Linux或OS X中,你也应该使用它。

text eof=lf 在checkout时,Git总是将文件结束符转换为LF。对于必须保留LF结尾的文件,即便是在Windows中,你也应该使用它。

binary Git会理解指定的文件不是文本,它就不会尝试去改变它们。这个设定是-text -diff 的别名。

在变更行结束符设置后刷新库

在你设定core.autocrlf配置,提交.gitattributes文件之后,你可能发现Git想去提交你未变更的文件。此时,Git是想为你改变每个文件的行结束符。

自动配置你的库的行结束符的最好方法是首先用Git备份你的文件,删除你的库(除了.git目录),然后立即恢复所有文件。

1.在Git中保存当前的文件,那么你的工作就不会丢失。

$ git add . -u
$ git commit -m "Saving files before refreshing line endings"

2.删除index,强制Git再扫描工作目录。

$ rm .git/index

3.重写Git的index,获取新的行结束符。

$ git reset

4.显示重写后的规范化文件 。

$ git status

5.将你变更的文件复原,准备提交。可以用这个机会检查哪些文件没有被改变。

$ git add -u
# It is perfectly safe to see a lot of messages here that read
# "warning: CRLF will be replaced by LF in file."

6.重写.gitattributes 文件。

$ git add .gitattributes

7.将你的改变提交到库中。

$ git commit -m "Normalize all the line endings"

测试

1.在Windows中创建一个文本文件file1.txt,提交,push

Git处理 行结束符-LMLPHP

2.在Linux中git clone,看到文件行结束符是CRLF

Git处理 行结束符-LMLPHP

3.添加.gitattributes文件,设置Git以它认为适当的方式处理行结束符。直接commit,push

Git处理 行结束符-LMLPHP

Git处理 行结束符-LMLPHP

4.在Linux中git clone,看到文件行结束符依然是CRLF

Git处理 行结束符-LMLPHP

5.按照【在变更行结束符设置后刷新库】设置后,在Linux中git clone,看到文件行结束符变为LF

Git处理 行结束符-LMLPHP

6.强制.txt设置为LF

Git处理 行结束符-LMLPHP

7.按照【在变更行结束符设置后刷新库】设置后 以及 在Windows中创建一个文本文件file2.txt,提交,push

Git处理 行结束符-LMLPHP

8.工作目录中的file1.txt,file2.txt还是CRLF,但是在Windows另一个文件夹中git clone,它们的行结束符变为LF。

Git处理 行结束符-LMLPHP

似乎在checkout时,文件的行结束符可以保证和配置中一致,但是原来的工作目录中似乎并没有改变。

05-23 22:31