git · Git

メッセージ

error: unable to unlink old 'dist/main.js': Permission denied

何を意味するか

checkout がファイルを新しい版に差し替えようとしたのに、OS が古いファイルの削除を許さなかったという意味です。別のプログラムがそのファイルを開いたままのとき(Windows で特に多い)、あるいはそのディレクトリに書き込み権限が無いときに出ます。そのファイルを掴んでいるもの — 開発サーバー、エディタ、ウイルス対策 — を閉じて同じ命令をもう一度実行し、Unix ならディレクトリの権限を直します。同じ命令の繰り返しは安全ですが、git が途中で止まっているため、成功するまで作業ディレクトリは半分だけ更新された状態で残ります。

直しかた

一行の命令では終わりません。何を見るべきかを説明に書いてあります。

出す道具
git
Git
29

git のエラーはほぼすべて「その状態でそれをやると何かが失われる」という拒否であり、fatal: は何も変えずに止まったという意味なので、一行目より下の hint: 行に本当の解決策が書かれていることが多いです。

エラーメッセージの読み方

  • 一行目から読みます。下に行くほど道具の内部の話で、原因はたいてい一番上に書かれています。
  • ファイル名と行番号があればそこが出発点です — スタックの最上段ではなく、自分が書いたファイルが出てくる一番上の行です。
  • 文句はそのまま検索します。ただし自分のパスや変数名は消します — その部分が検索を邪魔します。
  • 同じ事情が道具の版ごとに違う言い方で出ます。結果が合わないときは版番号も入れてみます。
  • 直す命令を貼る前に、その命令が何を捨てるかを確かめます。取り消せないものが混ざっています。

よくある質問

Q. error: unable to unlink old 'dist/main.js': Permission denied はどういう意味ですか。

checkout がファイルを新しい版に差し替えようとしたのに、OS が古いファイルの削除を許さなかったという意味です。別のプログラムがそのファイルを開いたままのとき(Windows で特に多い)、あるいはそのディレクトリに書き込み権限が無いときに出ます。そのファイルを掴んでいるもの — 開発サーバー、エディタ、ウイルス対策 — を閉じて同じ命令をもう一度実行し、Unix ならディレクトリの権限を直します。同じ命令の繰り返しは安全ですが、git が途中で止まっているため、成功するまで作業ディレクトリは半分だけ更新された状態で残ります。

Q. どう直しますか。

一行の命令では終わりません。何を見るべきかを上の説明に書いてあります。

Q. どの道具が出すエラーですか。

git です。Gitの仲間で、文句は8語です。

近いエラー