macosgithomebrew

Homebrew update fail: "Please, commit your changes or stash them before you can merge"


I am running:

brew update

And I get an error:

error: Your local changes to the following files would be overwritten by merge:
    samtools.rb
Please, commit your changes or stash them before you can merge.
Aborting

It turns out this is a well known error. In fact, it's mentioned on the Homebrew wiki:

After running brew update, you receive a git error warning about untracked files or local changes that would be overwritten by a checkout or merge, followed by a list of files inside your Homebrew installation.

This is caused by an old bug in in the update code that has long since been fixed. However, the nature of the bug requires that you do the following:

cd $(brew --repository)
git reset --hard FETCH_HEAD

If brew doctor still complains about uncommitted modifications, also run this command:

cd $(brew --repository)/Library
git clean -fd

I followed those instructions and am still seeing the same error. What is wrong?


Solution

  • I was able to resolve the issue myself.

    What tipped me off is running "git status" did not show that file.

    Instead of using the common solution:

    cd $(brew --repository)
    git reset --hard FETCH_HEAD
    

    I had to do:

    cd [directory of the file in question]
    git reset --hard FETCH_HEAD
    

    That resolved the problem.