Gitエラー「Pull is not possible because you have unmerged files」の原因と解決方法

Gitを使っていると、意味がわかりにくいエラーメッセージに遭遇することがあります。この記事では、バージョン管理作業でよく発生するあるエラーを取り上げ、その原因と具体的な解決策をわかりやすく解説します。

対象となるエラーメッセージは以下の通りです。

Pull is not possible because you have unmerged files.
Please, fix them up in the work tree, and then use 'git add/rm <file>'
as appropriate to mark resolution, or use 'git commit -a'.

エラーが発生する原因

このエラーは、作業ディレクトリ内に未解決のコンフリクト（競合）を含むファイルが残っている状態でgit pullを実行しようとしたときに発生します。Gitは安全のため、競合が解消されるまでリモートからの変更取り込みを拒否します。

つまり、まず該当ファイルを開いてマージコンフリクトを修正し、そのファイルをステージしてコミットすることで「解決済み」としてマークする必要があります。

解決手順

1. git status で状況を確認する

最初にすべきことは、ターミナルでgit statusを実行することです。これにより、どのファイルが未マージ（unmerged）状態なのかを把握できます。出力はおおよそ次のようになります。

Unmerged paths:
	use 'git add/rm <file>' to update what will be committed
	[ 対象ファイルの一覧 ]

必要に応じてgit diffを実行すると、コンフリクト箇所の詳細な差分を確認できます。

2. コンフリクトを修正する

チームメイトやパートナーと共同でプロジェクトを進めている場合、コンフリクトの原因は相手が書いたコードにあることが少なくありません。重要なコードをうっかり削除してしまわないよう、マージコンフリクトの内容は必ず相手と一緒に見直しましょう。

なお、マージ自体をやり直したい場合はgit merge --abortを実行すると、マージ前の状態に戻せます。

3. 解決をマークしてコミットする

すべてのコンフリクトを解決したら、git add <file>（削除した場合はgit rm <file>）で変更をステージし、git commit -aでコミットします。

4. 再度 pull を実行する

ここまで完了すれば、エラーは解消されています。あとは次のコマンドでリモートリポジトリから最新の変更を取得できます。

git pull origin [master | main | <ブランチ名>]

まとめ：このエラーは「未解決のコンフリクトがあるのにpullしようとしている」ことが原因です。git statusで未マージファイルを特定し、コンフリクトを修正してgit add/git commitで解決をマークすれば、正常にpullできるようになります。