同事偷偷改了git目录让我跑不起项目
大家好我是秋风，今天和大家分享一位铁杆读者 Ka_Ka 关于 Git 的故事，他进行了深入的探索，由于Git大小写不敏感引发的惨案，原文也可以在掘金查看：https://juejin.cn/post/6979105615541075999
前言
由于当年太年轻，资历不够深！！！导致文件命名不规范，现在想更正文件夹名字（
common => COMMON），结果发现一个很奇特的现象！git 对文件(夹)名的大小写不敏感！！！！引发了一些问题。最终经过查阅资料得以解决，遂！写下这篇帖子记录一下。走~跟着渣渣一起吃着花生 ? 喝着啤酒 ? 燥起来~
13.jpg
demo 部分目录结构
master 分支的代码及文件目录情况
# master分支原始目录
.
├── main.js
└── src
└── components
└── common
├── FootCell
│ └── index.vue
├── Pagination
│ └── index.vue
├── Table
│ └── index.vue
└── TitleCell
└── index.vue
// main.js
const files = require.context('../components/common', true, /\.vue$/)
准备工作
模拟多用户
user1分支：feature/user1user2分支：feature/user2此时分别有两个用户user1和user2在各自的电脑上拉取了这个项目。
骚操作开始 第一种
文件名的变更未同步到远端，但是引用路径却同步到远端了！
user1不知道git大小写不敏感,user2可知可不知，反正最后都!会!知!道!!!
09.gif
[user1]向远端同步变更
更改文件名 + 更改引用路径
因为 这里
git大小写不敏感所以只进行文件名变更(大小写)的话，不会被git检测到，所以必须要改动一个文件，让git检测到变更。才能进行commit!刚好文件名的变更导致了引用路径也需要变更！因此本次可以进行提交
由于被绿太狠了，心情不太好就开始了骚操作坑队友！common => COMMON结果如下：
# common => COMMON
.
├── main.js
└── src
└── components
└── COMMON
├── FootCell
│ └── index.vue
├── Pagination
│ └── index.vue
├── Table
│ └── index.vue
└── TitleCell
└── index.vue
// main.js
const files = require.context('../components/common', true, /\.vue$/)
最后并把代码提交到了远端,并且告诉 user2 代码有更新
[user2]的响应
pull 代码
user2于是乎就先pull然后merge了一下，把 user1 的代码同步到自己的分支，结果如下：
# 此时 common => common 没有变化！！！
.
├── main.js
└── src
└── components
└── common
├── FootCell
│ └── index.vue
├── Pagination
│ └── index.vue
├── Table
│ └── index.vue
└── TitleCell
└── index.vue
// main.js 有变化！！！
const files = require.context('../components/COMMON', true, /\.vue$/)
这个时候，“报应”来的太突然，项目报错了！引用的路径是COMMON而实际项目的路径是common
18.jpg
然后user2就好奇为啥会是这种情况,文件名没有变化？？于是乎开启了探索之路~~
探索问题
因为
user1被绿了一波，心情不好搞事情，害得user2引发了 bug，但是刚好激发了user2的好奇心。
- 为啥
user1的是COMMON,到我这里是common？？？ 最后user2查到了答案！原来是git对文件名的大小写不敏感，才会引发这个问题。好了那么接下来就是这么去解决这个问题呢？？
温馨提示
因为
git默认不区分大小写，所以如果只更改文件名的话git并不会检测到文件有变化，固！无法进行commit，所以这次测试在更改文件名的时候附带的改动了其他地方，以便提交！
解决问题
既然user2已经知道了 git 默认大小写不敏感，那就让他敏感呗。多简单！
[user2]更新变更
1. 开启 敏感模式
git config core.ignorecase false # 让你变的敏感
21.jpg
其实
user1压根就没有把文件名更改同步到到远端!(所以开头才说，他不知道git大小写不敏感!但是文件引用路径变更了，这个就导致其他人(user2)因为文件路径改变导致项目报错)
2. 切换分支，拉取最新代码
切分支 checkout
git che master
拉代码 pull
git pull
这个时候就会发现项目无法启动，因为
main.js中的文件路径引用已经由common => COMMON了，但实际文件名依旧是common
3. 手动更改文件名
common=>COMMON
19_git大小写不敏感引发的问题
4. 暂存、提交、push、切分支、merge 到 feature/user2 分支
暂存 add
git add .
提交 commit
git commit -m user2手动同步更新文件名
20_git大小写不敏感引发的问题
推送 push
# 这一步是替user1，将文件名变更同步到远端，供user3……等使用
#（此时如果其他用户是之前拉取的分支那么也会出现本篇文章所描述的问题！）
# 方法嘛~~ 就是当前文章~~哈哈哈
git push
切分支 checkout
git che feature/user2
08_D_git大小写不敏感引发的问题
09_git大小写不敏感引发的问题
merge master 到 feature/user2 分支
git merge master
10_git大小写不敏感引发的问题
11_git大小写不敏感引发的问题
查看 commit 记录
12_git大小写不敏感引发的问题
骚操作开始 第二种
文件名变更实际已经同步到远端了，且引用路径也同步到了远端！
- 这次
user1知道git大小写不敏感,user2同样可知可不知，于是一开始就逼迫她，让她变得敏感再敏感！
16.jpg
[user1]向远端同步变更
user1的分支：feature/user1
1. 让她敏感敏感再敏感
git config core.ignorecase false # emmmmm……俺敏感了
2. 更改文件名 & 文件引用路径
common => COMMON
更改引用路径
// 旧
const files = require.context('../components/common', true, /\.vue$/)
// 新
const files = require.context('../components/COMMON', true, /\.vue$/)
3. 暂存（add）& 提交(commit)
暂存 add
git add .
提交 commit
git commit -m <msg>
4. 切换分支
git checkout master
08_D_git大小写不敏感引发的问题
09_git大小写不敏感引发的问题
4.merge 到 master 并 pull 向远端
merge 结果如下：
git merge feature/user1 # user1的分支合并到本地master
10_git大小写不敏感引发的问题
11_git大小写不敏感引发的问题
推送 push
git push # 推送到远端master
[user2]更新变更
user2的分支：feature/user2
1. 开启 敏感模式·情况一
git config core.ignorecase false
2. 切分支 & pull 代码
切分支 checkout
git checkout master
拉代码 pull
git pull # 更新 master 分支
结果如下：
# 结果 error
KaKa:test2 xxx$ git pull
更新 5f318b9..5174f2e
error: 工作区中下列未跟踪的文件将会因为合并操作而被覆盖：
src/components/COMMON/FootCell/index.vue
src/components/COMMON/Pagination/index.vue
src/components/COMMON/Table/index.vue
src/components/COMMON/TitleCell/index.vue
请在合并前移动或删除。
正在终止
注意！上面那个问题一旦触发，那么你接下来所有的操作比如
check,switch,pull等操作都会报这个错误！！
其实上面已经告诉你怎么操作了，按照提示 删除或者移动原有的common文件夹,然后再pull(check,switch)即可解决
- 结果如下图：
common文件名已经变更为COMMON
11_git大小写不敏感引发的问题
3. 切换分支 & merge 代码
如果上一步问题解决了那么这一步就没什么异常了，user2 的分支代码已经被更新了
切分支 checkout
git checkout feature/user2
merge 代码
git merge master # 更新 feature/user2 分支
4 查看 commit 记录
- 如下图：
15_git大小写不敏感引发的问题
5 恭喜同步成功
33.jpg
1 关闭 敏感模式·情况二
git config core.ignorecase true # git 默认不敏感
2. 切分支 & pull 代码
切分支 checkout
git checkout master
拉代码 pull
git pull # 更新 master 分支
结果如下图：
13_git大小写不敏感引发的问题
惊不惊喜意不意外？
40.jpg
虽然远端的文件名已经由common => COMMON,但是当user2 执行pull的时候本地的文件名依旧还是老的common
3. 更改文件名、切换分支、merge master
先更改文件名
common => COMMON
再切换分支：
git checkout feature/user2
COMMON文件夹变成空的了
08_D_git大小写不敏感引发的问题
09_git大小写不敏感引发的问题
最后执行 merge 后的变化如下：
git merge master
COMMON文件夹又有内容了
14_git大小写不敏感引发的问题
4. 查看 commit
- 记录如下：
15_git大小写不敏感引发的问题
5. 恭喜同步成功
03.jpg
另外一种方式 git rm
删除文件夹 rm
git rm <文件夹路径> -r # -r 表示递归
删除文件 rm
git rm <文件路径>
[user1]向远端同步变更
1. 开启 敏感模式·情况一
git config core.ignorecase false
2. 制作副本
common => common copy
复制副本以后不能直接将 common copy 改成 COMMON (此时 common 还存在)
3. 使用 rm 删除 common 文件夹
git rm ./src/components/common -r # -r 表示递归
4. 还原名字
common copy => COMMON
看到这里有的同学该问了为啥不拷贝副本 common copy 以后立马直接对其变更名字(common copy => COMMON),然后执行第3步操作呢？？？？问的好啊。鼓掌 ?
16_git大小写不敏感引发的问题
看到这个结果·····
06.jpg
其实本人也是很想这么操作的，可是现在回头想想，在不区分大小写的情况下:
common === COMMON // true,
所以上面的提示是没有问题的 我个人认为
5. 暂存、commit、merge 到 master、推到远端
在这一步 你将遇到如下错误信息导致切换分支失败 (跟上面的还不太一样)
check 出问题
KaKa:test xxxx$ git che master
error: 工作区中下列未跟踪的文件将会因为检出操作而被覆盖：
src/components/common/FootCell/index.vue
src/components/common/Pagination/index.vue
src/components/common/Table/index.vue
src/components/common/TitleCell/index.vue
请在切换分支前移动或删除。
正在终止
此时的项目结构是这样子的：
.
├── README.md
├── main.js
└── src
└── components
└── COMMON <= # 重点！这里!!! 并没有 common
├── FootCell
│ └── index.vue
├── Pagination
│ └── index.vue
├── Table
│ └── index.vue
└── TitleCell
└── index.vue
```
并没有common文件夹！!那么就无解了？？但是否定的！那我们就:
忽略执行删除后的文件变更，直接 git checkout master
- 把
COMMON=>common - 最后执行
git check master
merge 出问题
KaKa-3:test xxxx$ git merge feature/user1
更新 5f318b9..24b399d
error: 工作区中下列未跟踪的文件将会因为合并操作而被覆盖：
src/components/COMMON/FootCell/index.vue
src/components/COMMON/Pagination/index.vue
src/components/COMMON/Table/index.vue
src/components/COMMON/TitleCell/index.vue
请在合并前移动或删除。
正在终止
并没有COMMON,处理方法同上:
- 把
common=>COMMON - 最后
git merge feature/user1就可以了~
6. 查看 commit 记录
- 如下图：
1. 关闭 敏感模式·情况二
git config core.ignorecase true
2. 更改文件名
common=>COMMON然而尴尬的一幕它发生了！！！如下图：
11_git大小写不敏感引发的问题
10_git大小写不敏感引发的问题卧槽！Git 并没有检测到 文件有变化！
3. 卒!
- 这种情况要么放弃，要么开启敏感模式！如果开启那就是
情况一了
46.jpg
[user2]更新变更
此时 user2的master 分支初始目录如下：
.
├── README.md
├── main.js
└── src
└── components
└── common
├── FootCell
│ └── index.vue
├── Pagination
│ └── index.vue
├── Table
│ └── index.vue
└── TitleCell
└── index.vue
1. 开启 敏感模式·情况一
git config core.ignorecase false
2. pull 最新代码
KaKa:test2 xxxx$ git pull
更新 5f318b9..24b399d
error: 工作区中下列未跟踪的文件将会因为合并操作而被覆盖：
src/components/COMMON/FootCell/index.vue
src/components/COMMON/Pagination/index.vue
src/components/COMMON/Table/index.vue
src/components/COMMON/TitleCell/index.vue
请在合并前移动或删除。
正在终止
不出所料 会跟开头讲的 状况一致，这里就不重复赘述了，参考上面的即可解决。
3. 查看 commit 记录
- 如下图:
17_git大小写不敏感引发的问题
1. 关闭 敏感模式·情况二
git config core.ignorecase true
2. pull 最新代码
- 如下图
18_git大小写不敏感引发的问题同前面所说,变更都过来了，唯独文件名由于本地的大小写不敏感，所以没有自动变更名字
3. 手动更改文件名
common => COMMON
4. 切换分支，mer master 代码
切分支 checkout
git checkout feature/user2
merge 代码
git merge master
5. 查看 commit 记录
- 如下图:
17_git大小写不敏感引发的问题
总结
综上的出来的结论就是多人协作开发的时候存在已下情况
- 第一种方式
user1两种，user2两种，总共四种情况。且文件都被标记为A- 都未开启敏感模式（绝大多数都是这个情况） 这种情况可想而知，远端的文件名一直都是 common 而非 COMMON，所有人乃至以后都会一直存在这个问题（自己本地需要去手动的更改文件名），
- 都开启了敏感模式
这种情况
user2在同步更新master分支代码的时候会遇到error，根据提示删除或移动文件位置即可！（删除最简单直观） - 修改方(
user1)开起了敏感模式，被通知方(user2)未开启 虽然文件名已经被改动且同步到了远端，但是当 user2 （master）拉取的时候会发现自己本地的文件名依旧是 common 未改动。这个时候只需要手动的去更改文件名，然后merge到user2的分支即可 - 修改方(
user1)未开启敏感模式，被通知方(user2)开启了user1自以为文件名已经更改成功且同步到了远端，实际并没有同步到远端，user2自己手动更改，更改后push到远端，这样所有人的文件引用路径错误问题都能得到解决
- 第二种方式
通过
git rm这个操作来处理。通过这种方式变更文件会被标记为R
结束语
已上所有内容都是经过好几遍测试，一遍实践一遍记录的形式来撰写的，最后也反复检查了好几遍，目测没有什么问题，如果有问题了就请留言告知吧~
47.jpg
关注公众号秋风的笔记，一个专注于前端面试、工程化、开源的前端公众号
- 关注后回复
简历获取100+套的精美简历模板 - 关注后回复
好友拉你进技术交流群+面试交流群 - 欢迎关注
秋风的笔记