I have changed a few files name by de-capitalize the first letter, as in Name.jpg to name.jpg. Git does not recognize this changes and I had to delete the files and upload them again. Is there a way that Git can be case-sensitive when checking for changes in file names? I have not made any changes to the file itself.
24 Answers
As long as you're just renaming a file, and not a folder, you can just use git mv:
git mv -f relative/path/to/yOuRfIlEnAmE relative/path/to/yourfilename
(As of a change in Git 2.0.1, the -f flag in the incantation above is superfluous, but it was needed in older Git versions.)
20 Comments
-f switch with the latest git (2.18) otherwise you could get the fatal: destination exists error.git mv for each file in the directory instead.Git has a configuration setting that tells it whether to expect a case-sensitive or insensitive file system: core.ignorecase. To tell Git to be case-sensitive, simply set this setting to false. (Be careful if you have already pushed the files, then you should first move them given the other answers).
git config core.ignorecase false
Note that setting this option to false on a case-insensitive file system is generally a bad idea. Doing so will lead to weird errors. For example, renaming a file in a way that only changes letter case will cause git to report spurious conflicts or create duplicate files(from Mark Amery's comment).
Documentation
From the git config documentation:
core.ignorecaseIf true, this option enables various workarounds to enable git to work better on filesystems that are not case sensitive, like FAT. For example, if a directory listing finds
makefilewhen git expectsMakefile, git will assume it is really the same file, and continue to remember it asMakefile.The default is false, except git-clone(1) or git-init(1) will probe and set
core.ignorecasetrue if appropriate when the repository is created.
Case-insensitive file-systems
The two most popular operating systems that have case-insensitive file systems that I know of are
- Windows
- OS X
29 Comments
false on a case-insensitive file system is a bad idea. This isn't necessarily obvious. For example, I just tried this on my Mac, thinking it would fix my problems, then renamed a file from productPageCtrl.js to ProductPageCtrl.js. git status saw a new file called ProductPageCtrl.js but didn't think that productPageCtrl.js had been deleted. When I added the new files, committed, and pushed to GitHub, the GitHub repo now contained both files even though my (supposedly up to date) local repo had only one.git mv to move the file and see how git manages it. If you move the file without git, there is nothing git can do as the filesystem isn't telling the truth to git. This is an issue of ntfs/fat/hfs and thelike and not git/linux.Fix git filename case on whole repo:
(replace . with (sub-)folder name for just part of the repo)
git rm -r --cached .
git add --all .
git status ##Review that **only** changes staged are renames
## Commit your changes after reviewing:
git commit -a -m "Fixing file name casing"
git push origin main
Explanation from @Uriahs Victor comment:
What this command actually does is deletes the cached version of the file/folder names that git thought still existed. So it will clear its cache but leave everything in the current folder (where you've made your changes locally) but it will see that those other wrong case folders/files do not exist anymore so will show them as deleted in git status. Then you can push up to GitHub and it will remove the folders/files with wrong cases. This answer has a graphic depicting what the command means.
Caveats
- This removes files that were
.gitignore'd, but force-added inside an ignored folder, e.g.git add -f ignored/folder/force-added.file. Simply revert the deletion withgit checkout HEAD -- ignored/folder/force-added.file - This removes explicit git file permissions (
git update-index --chmod=...) from files, e.g.gradlew. Either re-apply the permissions manually until the file is no longer showing as "modified" ingit status; or reset the file to what's in the repo:git checkout HEAD -- path/to/file/with/executable-bit.set - For submodules we can get "You've added another git repository inside your current repository." warning, in that case do what it says:
git rm --cached submodule/path git submodule add <url-of-submodule-remote> submodule/path
9 Comments
git status. Then you can push up to github and it will remove the folders/files with wrong cases. This answer has a graphic depicting what the command means: stackoverflow.com/a/41863575/4484799git config core.ignorecase false. Although the case changes appeared in my local repo, on pushing to GitHub the pre-case-changed files appeared alongside their case-changed twins. These steps fixed the issue on GitHub.Using SourceTree I was able to do this all from the UI
- Rename
FILE.exttowhatever.ext - Add/Stage that file
- Now rename
whatever.exttofile.ext - Add/Stage that file again
It's a bit tedious, but if you only need to do it to a few files it's pretty quick
9 Comments
This is what I did on OS X:
git mv File file.tmp
git mv file.tmp file
Two steps because otherwise I got a “file exists” error. Perhaps it can be done in one step by adding --cached or such.
5 Comments
-f (force) is the flag you are looking for-f flag doesn't help in case the underlying FS is case-insensitive. However, two-step solution worked for me-f worked! Thanks for the tip-f flag.git -c "core.ignorecase=false" add . will consider files whose case has been changed for commit.Sometimes it is useful to temporarily change Git's case sensitivity. Here's how:
Method #1 - Change case sensitivity for a single command:
git -c core.ignorecase=true checkout<<branch name>> to turn off case-sensitivity for a single checkout command. Or more generally: git -c core.ignorecase= <<true or false>> <<command>>. (Credit to VonC for suggesting this in the comments.)
Method #2 - Change case sensitivity for multiple commands:
To change the setting for longer (e.g. if multiple commands need to be run before changing it back):
git config core.ignorecase(this returns the current setting, e.g.false).git config core.ignorecase<<true or false>>- set the desired new setting.- ...Run multiple other commands...
git config core.ignorecase<<false or true>>- set config value back to its previous setting.
5 Comments
git -c core.ignorecase=<true or false> checkout <<branch>>? Nothing to reset after.We can use git mv command. Example below , if we renamed file abcDEF.js to abcdef.js then we can run the following command from terminal
git mv -f .\abcDEF.js .\abcdef.js
1 Comment
Under OSX, to avoid this issue and avoid other problems with developing on a case-insensitive filesystem, you can use Disk Utility to create a case sensitive virtual drive / disk image.
Run disk utility, create new disk image, and use the following settings (or change as you like, but keep it case sensitive):

Make sure to tell git it is now on a case sensitive FS:
git config core.ignorecase false
4 Comments
rename file
Name.jpgtoname1.jpgcommit removed file
Name.jpgrename file
name1.jpgtoname.jpgamend added file
name.jpgto previous commitgit add name.jpg git commit --amend
4 Comments
fatal: bad source, source=name1.jpg, destination=name.jpg at step 3. Do you have suggestion? Thxgit add.Similar to @Sijmen's answer, this is what worked for me on OSX when renaming a directory (inspired by this answer from another post):
git mv CSS CSS2
git mv CSS2 css
Simply doing git mv CSS css gave the invalid argument error: fatal: renaming '/static/CSS' failed: Invalid argument perhaps because OSX's file system is case insensitive
p.s BTW if you are using Django, collectstatic also wouldn't recognize the case difference and you'd have to do the above, manually, in the static root directory as well
Comments
I tried the following solutions from the other answers and they didn't work:
If your repository is hosted remotely (GitHub, GitLab, BitBucket), you can rename the file on origin (GitHub.com) and force the file rename in a top-down manner.
The instructions below pertain to GitHub, however the general idea behind them should apply to any remote repository-hosting platform. Keep in mind the type of file you're attempting to rename matters, that is, whether it's a file type that GitHub deems as editable (code, text, etc) or uneditable (image, binary, etc) within the browser.
- Visit GitHub.com
- Navigate to your repository on GitHub.com and select the branch you're working in
- Using the site's file navigation tool, navigate to the file you intend to rename
- Does GitHub allow you to edit the file within the browser?
- a.) Editable
- Click the "Edit this file" icon (it looks like a pencil)
- Change the filename in the filename text input
- b.) Uneditable
- Open the "Download" button in a new tab and save the file to your computer
- Rename the downloaded file
- In the previous tab on GitHub.com, click the "Delete this file" icon (it looks like a trashcan)
- Ensure the "Commit directly to the
branchnamebranch" radio button is selected and click the "Commit changes" button - Within the same directory on GitHub.com, click the "Upload files" button
- Upload the renamed file from your computer
- a.) Editable
- Ensure the "Commit directly to the
branchnamebranch" radio button is selected and click the "Commit changes" button - Locally, checkout/fetch/pull the branch
- Done
4 Comments
Years later I need to come back to this question and provide yet another possible solution! I ran into this issue on a project where only a single file needed to be renamed. This is what I did and it worked for me.
git mv -f src/MyFile.js src/myfile.js
Which I learned both from this thread and this answer
Comments
Mac OSX High Sierra 10.13 fixes this somewhat. Just make a virtual APFS partition for your git projects, by default it has no size limit and takes no space.
- In Disk Utility, click the + button while the Container disk is selected
- Select APFS (Case-Sensitive) under format
- Name it
Sensitive - Profit
- Optional: Make a folder in Sensitive called
gitandln -s /Volumes/Sensitive/git /Users/johndoe/git
Your drive will be in /Volumes/Sensitive/
How do I commit case-sensitive only filename changes in Git?
3 Comments
APFS (Case-sensitive) makes your system very slow and you will face many weird issue, I faced ReactNative build issue, some addresses could not be found. so it's better to have APFS the default of the company. for git case it's better to use this solution.so there are many solutions to this case sensitivity deployment problem with how GitHub handles it.
In my case, I had changed the filename casing convention from uppercase to lowercase.
I do believe that git can track the change but this command
git config core.ignorecase false dictates how git operates behind the scenes
In my case, I ran the command and git suddenly had lots of files to track labeled untracked.
I then hit git add. , then git committed and ran my build on netlify one more time.
Then all errors now displayed could be traced e.g
Module not found: Can't resolve './Components/ProductRightSide' in '/opt/build/repo/components/products and fixed such that git was able to track and implement the changes successfully.
It's quite a workaround and a fingernail away from frustration but trust me this will surely work.
PS: after fixing your issue you may want to run the command
git config core.ignorecase true to restore how git works with case sensitivity.
Also, note git config core.ignorecase false has issues with other filename extensions so you may want to watch out, do it if you know what you’re doing and are sure of it.
Here's a thread on netlify that can help out, possibly
1 Comment
When you've done a lot of file renaming and some of it are just a change of casing, it's hard to remember which is which. manually "git moving" the file can be quite some work. So what I would do during my filename change tasks are:
- remove all non-git files and folder to a different folder/repository.
- commit current empty git folder (this will show as all files deleted.)
- add all the files back into the original git folder/repository.
- commit current non-empty git folder.
This will fix all the case issues without trying to figure out which files or folders you renamed.
1 Comment
git commmit --amend in In paragraph 4? Otherwise, there will be an extra commit with the removal of all files. Or you can use git rebase -i with squash.I've faced this issue several times on MacOS. Git is case sensitive but Mac is only case preserving.
Someone commit a file: Foobar.java and after a few days decides to rename it to FooBar.java. When you pull the latest code it fails with The following untracked working tree files would be overwritten by checkout...
The only reliable way that I've seen that fixes this is:
git rm Foobar.java- Commit it with a message that you cannot miss
git commit -m 'TEMP COMMIT!!' - Pull
- This will pop up a conflict forcing you to merge the conflict - because your change deleted it, but the other change renamed (hence the problem) it
- Accept your change which is the 'deletion'
git rebase --continue
- Now drop your workaround
git rebase -i HEAD~2anddroptheTEMP COMMIT!! - Confirm that the file is now called
FooBar.java
1 Comment
git rebase --continue without a rebase in progress just yields a "No rebase in progress?" error, and there's no rebase in progress during step 4.2, so running that command there doesn't make sense either.I took @FiniteLooper answer and wrote a Python 3 Script to do it with a list of files:
#!/usr/bin/env python3
# -*- coding: UTF-8 -*-
import os
import shlex
import subprocess
def run_command(absolute_path, command_name):
print( "Running", command_name, absolute_path )
command = shlex.split( command_name )
command_line_interface = subprocess.Popen(
command, stdout=subprocess.PIPE, cwd=absolute_path )
output = command_line_interface.communicate()[0]
print( output )
if command_line_interface.returncode != 0:
raise RuntimeError( "A process exited with the error '%s'..." % (
command_line_interface.returncode ) )
def main():
FILENAMES_MAPPING = \
[
(r"F:\\SublimeText\\Data", r"README.MD", r"README.md"),
(r"F:\\SublimeText\\Data\\Packages\\Alignment", r"readme.md", r"README.md"),
(r"F:\\SublimeText\\Data\\Packages\\AmxxEditor", r"README.MD", r"README.md"),
]
for absolute_path, oldname, newname in FILENAMES_MAPPING:
run_command( absolute_path, "git mv '%s' '%s1'" % ( oldname, newname ) )
run_command( absolute_path, "git add '%s1'" % ( newname ) )
run_command( absolute_path,
"git commit -m 'Normalized the \'%s\' with case-sensitive name'" % (
newname ) )
run_command( absolute_path, "git mv '%s1' '%s'" % ( newname, newname ) )
run_command( absolute_path, "git add '%s'" % ( newname ) )
run_command( absolute_path, "git commit --amend --no-edit" )
if __name__ == "__main__":
main()
Comments
If nothing worked use git rm filename to delete file from disk and add it back.
1 Comment
If you have many files to rename, and a large repository, many of the answers here won't apply. I found a hack for my particular use case: where you already have a relatively easy way to correct the files on the filesystem (I happened to have a set of files with correct casing that I could drag over the top of the files tracked in the git repo, which fixed it for me on the f/s of macOS Catalina looking at an NTFS partition). Correcting the filesystem DID NOTHING to fix it in git's history, no matter what core.ignorecase is set to, unless:
- Have a clean
git status. Setgit config core.ignorecase false - Do whatever you have to do to make the casing on your filesystem correct
- Note
git ls-filesshows you git is now tracking BOTH casings of files, despite only correct casing on f/s, this looks like a bad situation, but: git checkout .: Git removes BOTH casings of all AFFECTED files from its history, Add and Commit- Do whatever you did in step 2 again to replace those files (perhpas a better command for the previous step might mitigate having to do this?) Your
git statusnow shows as newly-added to git only those files with casing problems, instead of your whole filetree. Add and Commit again - Set
ignorecaseback to true if this f/s is where you work (recommended for case-insensitive filesystems (and we just saw a reason why!) and be more careful in future...
Comments
if you are like us and you are working on Azure Devops and you have a mixed team of apple and windows users, sometimes the filenames get the wrong casing, the easies way to solve it when you are in that environment is to rename it in the files page of the online Azure Devops portal, see on this screenshot
Comments
If you're doing more complex change, like directory name casing change, you can make that change from a Linux machine, because Linux itself (as well as git on Linux) treats files/directories with same names but different casing as completely different files/directories.
So if you're on Windows, you can install Ubuntu using WSL, clone your repo there, open the cloned repo directory using VSCode (use WSL remote extension to access WSL Ubuntu from Windows), then you will be able to make your renames through VSCode and commit/push them using VSCode git integration.


git mvworks.gitworking copies. Spares a lot of my sanity, I must admit...