1.出现的问题
前几天拉代码时,发现项目下的node_modules
文件夹消失了,当时也没想那么多,反手就是一个npm install
,悠哉游哉的看着屏幕上不断翻滚的一个个字符。
等到包全部安装好了,我又操作了一段时间的代码,准备将更改的代码上传git
,这才发现自己闯了多大的祸。
这次的项目里没有配置gitignore
文件,也就意味着,我那sourcetree
(git
图形化工具)的未上传文件达到了惊人的13217个!全部是之前install
的包,直接让sourcetree
卡死在了那里。提交提交不了,关闭关闭不了。一直提示:
Another git process seems to be running in this repository,
e.g. an editor opened by ‘git commit’.
Please make sure all processes are terminated then try again.
If it still fails, a git process remove the file manually to continue…
这段话的意思翻译过来就是git
被另外一个进程占用,确保所有的进程都终止后再进行尝试,其实也就是由于我当时的文件量实在太大,git
在使用过程中崩溃了,一些资源被上锁没有释放导致的这个问题。
虽然我有尝试重启sourcetree
,不过仍然没有解决问题,只要打开就会卡死。
一般情况下——也就是文件不太多的时候,可以通过删除项目文件夹下的.git
目录下的index.lock
文件来解决问题。但是因为我本地的文件数量过于庞大,因此即使删除了index.lock
文件,sourcetree
的进程也会很快被下一个文件给堵塞掉,生成一个新的index.lock
文件,简直无解。
2.解决方案
以前从来没有碰到过这种情况的我慌了神,还好身边的同事及时提醒:你是不是没有gitignore
文件啊。
gitignore
文件——顾名思义,就是在上传git时设置的需要忽略的一些东西,比如编译时生成的临时文件啊、日志啊、install
的一些包啊、打包时生成的dist
文件啊等等。这些东西如果上传到git
中去,被其他人拉取下来之后,可能会与他本地的配置有冲突。
因此,git
为我们提供了一个非常简便的办法:在git
工作区的根目录下创建一个特殊的.gitignore
文件,然后把要忽略的文件名填进去,git
就会自动忽略这些文件。
3.gitignore
详解
-
.gitignore
忽略文件的原则
- 忽略操作系统自动生成的文件,比如缩略图等;
- 忽略你自己的带有敏感信息的配置文件,比如存放口令的配置文件;
- 忽略编译生成的中间文件、可执行文件等,也就是如果一个文件是通过另一个文件自动生成的,那自动生成的文件就没必要放进版本库,比如
Java
编译产生的.class
文件
-
.gitignore
忽略规则的优先级
- 从命令行中读取可用的忽略规则
- 当前目录定义的规则
- 父级目录定义的规则,依次递推
4.$GIT_DIR/info/exclude
文件中定义的规则core.excludesfile
中定义的全局规则
-
.gitignore
忽略规则的匹配语法
- 空格不匹配任意文件,可作为分隔符,可用反斜杠转义
- 以“#”开头的行都会被
Git
忽略。即#开头的文件标识注释,可以使用反斜杠进行转义。
- 可以使用标准的
glob
模式匹配。所谓的glob
模式是指shell
所使用的简化了的正则表达式。
- 以斜杠"/"开头表示目录;
"/"结束的模式只匹配文件夹以及在该文件夹路径下的内容,但是不匹配该文件;
"/"开始的模式匹配项目跟目录;
如果一个模式不包含斜杠,则它匹配相对于当前.gitignore
文件路径的内容,
如果该模式不在.gitignore
文件中,则相对于项目根目录。
- 以星号""通配多个字符,即匹配多个任意字符;
使用两个星号"*" 表示匹配任意中间目录
- 以问号"?"通配单个字符,即匹配一个任意字符;
- 以方括号"[]"包含单个字符的匹配列表,即匹配任何一个列在方括号中的字符;
- 以叹号"!"表示不忽略(跟踪)匹配到的文件或目录,即要忽略指定模式以外的文件或目录,可以在模式前加上惊叹号(!)取反
注意: git
对于 .gitignore
配置文件是按行从上到下进行规则匹配的
-
.gitignore
常用的几种忽略规则
node_modules 忽略node_modules文件夹
*.zip 忽略所有.zip结尾的文件
/dist 忽略项目根目录下的dist文件夹,但不包括子目录下的dist文件夹
build/ 忽略 build/目录下的所有文件,包括子目录下的文件
-
特别注意
如果在创建.gitignore
文件之前就push
了项目,那么即使在.gitignore
文件中写入新的过滤规则,这些规则也不会起作用,git
仍然会对所有文件进行版本管理。
出现这种问题的原因是git
已经开始管理这些文件了,所以无法再通过过滤规则过滤它们。
这种时候可以先把本地缓存删除,然后再提交,具体操作如下:
git rm -r --cached
git add
git commit -m 'update .gitignore'