·오류 문구 사전

git · Git

오류 문구

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

무슨 뜻인가

checkout이 파일을 새 판으로 갈아 끼우려는데 운영체제가 옛 파일을 지우지 못하게 막았다는 뜻입니다. 다른 프로그램이 그 파일을 열어 두고 있거나(윈도우에서 특히 흔합니다), 그 디렉터리에 내가 쓸 권한이 없을 때 나옵니다. 그 파일을 붙잡고 있는 것 — 개발 서버, 편집기, 백신 — 을 닫고 같은 명령을 다시 실행하면 되고, 유닉스라면 디렉터리 권한을 고칩니다. 같은 명령을 되풀이해도 안전합니다. 다만 git이 중간에 멈춘 상태라 성공할 때까지 작업 디렉터리는 반쯤 갈린 채로 남아 있습니다.

고치는 명령

한 줄 명령으로 끝나지 않습니다. 설명에 무엇을 봐야 하는지 적어 두었습니다.

내는 도구
git
Git
29

git의 오류는 거의 다 "지금 상태에서 그 일을 하면 무언가 잃는다"는 거절이고, fatal:은 아무것도 하지 않고 멈췄다는 뜻이니 첫 줄보다 그 아래 hint: 줄이 실제 해법을 담고 있는 경우가 많습니다.

오류 문구를 읽는 법

  • 첫 줄부터 읽습니다. 아래로 갈수록 도구 내부 이야기이고, 정작 원인은 맨 위에 적혀 있습니다.
  • 파일 이름과 줄 번호가 있으면 거기가 시작점입니다 — 스택의 가장 위가 아니라, 내가 쓴 파일이 나오는 가장 위 줄입니다.
  • 문구를 그대로 검색합니다. 다만 내 경로와 변수 이름은 지웁니다 — 그 부분이 검색을 방해합니다.
  • 같은 문구가 도구 판마다 다르게 나옵니다. 검색 결과가 안 맞으면 판 번호를 함께 넣어 봅니다.
  • 고치는 명령을 붙여 넣기 전에 그 명령이 무엇을 버리는지 확인합니다. 되돌릴 수 없는 것이 섞여 있습니다.

자주 묻는 질문

Q. error: unable to unlink old 'dist/main.js': Permission denied 는 무슨 뜻인가요?

checkout이 파일을 새 판으로 갈아 끼우려는데 운영체제가 옛 파일을 지우지 못하게 막았다는 뜻입니다. 다른 프로그램이 그 파일을 열어 두고 있거나(윈도우에서 특히 흔합니다), 그 디렉터리에 내가 쓸 권한이 없을 때 나옵니다. 그 파일을 붙잡고 있는 것 — 개발 서버, 편집기, 백신 — 을 닫고 같은 명령을 다시 실행하면 되고, 유닉스라면 디렉터리 권한을 고칩니다. 같은 명령을 되풀이해도 안전합니다. 다만 git이 중간에 멈춘 상태라 성공할 때까지 작업 디렉터리는 반쯤 갈린 채로 남아 있습니다.

Q. 어떻게 고치나요?

한 줄 명령으로 끝나지 않습니다. 위 설명에서 무엇을 봐야 하는지 적어 두었습니다.

Q. 어느 도구가 내는 오류인가요?

git입니다. Git 갈래에 있고, 문구는 8낱말입니다.

같이 나는 오류