여러 사용자가 명령 프롬프트(Command Prompt)에서 git 명령을 실행하려고 할 때 "'git'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램 또는 배치 파일이 아닙니다"라는 오류 메시지가 표시된다고 보고하고 있습니다. 일부 사용자는 Windows용 Git을 설치한 후 어느 시점부터 이 문제가 발생했다고 보고한 반면, 다른 사용자는 Git 설치가 완료되자마자 이 문제에 직면하기도 합니다.
'git'은(는) 내부 또는 외부 명령 오류의 원인
다양한 사용자 보고를 바탕으로 이 문제를 조사한 결과, 이 오류가 발생하는 몇 가지 시나리오를 확인할 수 있었습니다:
- 환경 변수에 Git PATH가 설정되지 않았거나 잘못 설정됨 – 최근 소프트웨어 변경 사항이나 사용자 실수로 인해 변수 목록의 Git PATH가 올바르게 구성되지 않았을 수 있습니다.
- Git 설치 중 CMD 창이 열려 있었음 – Windows용 Git을 설치하는 동안 명령 프롬프트 창이 열려 있었다면, 명령 프롬프트를 다시 여는 것만으로도 문제가 해결될 수 있습니다.
이 문제를 해결하는 데 어려움을 겪고 있다면, 이 글에서 몇 가지 문제 해결 가이드를 제공해 드립니다. 아래에는 비슷한 상황에 있는 다른 사용자들이 문제를 해결하는 데 사용한 방법들을 정리했습니다. 가장 좋은 결과를 얻으려면 순서대로 방법을 따라 하면서 본인의 상황에 맞는 해결책을 찾아보세요.
방법 1: 명령 프롬프트 다시 열기
터미널을 즐겨 사용하시는 분이라면 Git 설치 중에도 CMD 창을 항상 열어두는 경우가 많습니다. 이 경우 명령 프롬프트가 최신 환경 변수 변경 사항으로 업데이트되지 않아 문제가 발생할 수 있습니다.
이 시나리오에 해당한다면 해결 방법은 아주 간단합니다. CMD 창을 닫고 새 창을 열기만 하면 됩니다. 경로가 올바르게 설정되어 있다면 "'git'은(는) 내부 또는 외부 명령..." 오류 없이 Git 명령을 정상적으로 사용할 수 있습니다.
이 시나리오가 해당하지 않는다면, 아래의 다음 방법으로 넘어가세요.
방법 2: Git 설치 GUI를 통한 PATH 자동 설정
PATH 변수를 직접 수정하고 싶지 않다면, Git 설치 마법사(GUI)를 활용하여 Path 변수를 자동으로 생성하도록 설정함으로써 이 오류를 해결할 수 있습니다. 이렇게 하면 Git Bash와 Windows 명령 프롬프트 양쪽에서 모두 Git을 사용할 수 있습니다.
다음은 Git을 제거한 후 초기 설치 과정에서 경로 변수를 자동으로 추가하도록 구성하는 단계별 가이드입니다:
- Windows 키 + R을 눌러 실행 대화 상자를 엽니다. 그런 다음 "appwiz.cpl"을 입력하고 Enter 키를 눌러 프로그램 및 기능 창을 엽니다.
- 프로그램 및 기능 창에서 Git 항목을 찾아 마우스 오른쪽 버튼으로 클릭한 후 제거를 선택합니다. 화면의 지시에 따라 현재 설치된 Git을 제거합니다.
- 제거 프로세스를 완료하기 위해 컴퓨터를 다시 시작합니다.
- 공식 웹사이트(git-scm.com)에 접속하여 최신 버전의 Windows용 Git을 다운로드합니다. 다운로드가 자동으로 시작되며, 시작되지 않으면 운영체제 비트 아키텍처에 맞는 버전을 클릭하세요.
- 설치 실행 파일을 열고 설치 지시에 따라 진행합니다. 모든 옵션은 기본값으로 두어도 됩니다. Adjusting your PATH environment(PATH 환경 조정) 단계에 도달하면 반드시 Use Git from Windows Command Prompt(Windows 명령 프롬프트에서 Git 사용) 옵션을 선택하세요.
- 나머지 설치 구성은 기본 선택값을 유지하거나 원하는 값으로 지정한 후 Install 버튼을 클릭합니다.
- 설치가 완료되면 컴퓨터를 다시 시작합니다. 다음 부팅 후에는 Windows 명령 프롬프트에서 직접 git 명령을 실행할 수 있습니다.
Git 클라이언트를 제거하지 않고 문제를 해결하는 방법을 찾고 있다면, 아래의 다음 방법으로 넘어가세요.
방법 3: PATH 변수 수동 추가
여기까지 진행했는데도 결과가 없다면, 환경 변수(Environment Variables)에 Git 변수가 구성되지 않았거나 잘못 구성되어 이 문제가 발생하고 있을 가능성이 매우 높습니다.
다행히도 다음 지침에 따라 변수 값을 수동으로 구성할 수 있습니다. 필요한 작업은 다음과 같습니다:
- 파일 탐색기를 열고 Git 설치 폴더 안의 cmd 폴더 위치로 이동합니다. x86 및 x64 버전의 기본 경로는 다음과 같습니다:
내 PC > 로컬 디스크(C:) > Program Files (x86) > Git > cmd 내 PC > 로컬 디스크(C:) > Program Files > Git > cmd
- 다음으로 git.exe 파일을 마우스 오른쪽 버튼으로 클릭하고 속성(Properties)을 선택합니다. git.exe 속성의 일반 탭에서 실행 파일의 위치를 복사합니다(나중에 필요합니다).
- Windows 키 + R을 눌러 실행 대화 상자를 연 다음, "sysdm.cpl"을 입력하고 Enter 키를 눌러 시스템 속성 메뉴를 엽니다.
- 시스템 속성 메뉴에서 고급 탭으로 이동한 후 환경 변수 버튼을 클릭합니다.
- 환경 변수 메뉴에서 시스템 변수 하위 목록으로 이동하여 Path를 선택한 후 편집 버튼을 클릭합니다.
- 환경 변수 편집 창에서 새로 만들기 버튼을 클릭하고 2단계에서 복사한 위치를 붙여넣습니다. 그런 다음 Enter 키를 눌러 변수를 생성합니다.
- 변경 사항이 저장되도록 열려 있는 모든 창에서 확인을 클릭합니다.
- CMD 창을 열고 "git"을 입력합니다. 더 이상 "'git'은(는) 내부 또는 외부 명령..." 오류가 발생하지 않을 것입니다.
