Git 설치 후 PowerShell에서 git을 인식하지 못할 때

1. 오류가 발생한 셸과 명령 기록

PowerShell에서 git --version을 실행했을 때 인식할 수 없는 명령이라는 메시지가 뜨는 경우를 다룹니다. 서버 로그인 실패나 커밋 작성자 오류는 Git이 이미 실행된 뒤의 문제이므로 이 문서의 대상과 다릅니다. 설치형인지 Portable인지, 설치 후 PC나 터미널을 새로 시작했는지, 어디에서 명령을 입력했는지 먼저 적어 둡니다.

2. 새 외부 PowerShell에서 확인

설치 전부터 열려 있던 창을 그대로 사용했다면 새 PowerShell을 열어 같은 명령을 실행합니다. 새 창에서만 성공하면 기존 프로세스가 이전 PATH를 유지한 상황입니다. VS Code 안에서만 실패할 때는 터미널 탭만 추가하는 것보다 편집기를 다시 시작해 설치 후 환경을 전달받도록 합니다.

git --version

3. Git Bash와 비교해 설치 여부 좁히기

시작 메뉴의 Git Bash에서 같은 명령을 실행합니다. Bash에서는 버전이 나오고 PowerShell에서는 실패한다면 Git 실행 파일은 존재하고 일반 셸의 검색 범위를 확인할 차례입니다. 두 곳 모두 실패하거나 Git Bash 항목이 없다면 Portable을 선택했는지, 설치가 완료됐는지 확인합니다. Portable 폴더를 지웠다면 새 경로를 임의로 등록해도 실행 파일을 찾을 수 없습니다.

4. 실제 실행 파일과 명령 검색 경로 확인

PowerShell에서 where.exe git과 Get-Command git -All을 실행해 현재 셸이 선택하는 파일을 확인합니다. 결과가 여러 개면 어떤 경로가 먼저 선택되는지 봅니다. 아무것도 나오지 않으면 설치된 앱과 Git 폴더에서 실제 git.exe를 찾고 설치형·Portable 중 무엇인지 대조하세요. 설치 위치는 바꿀 수 있으므로 예시 경로만 그대로 PATH에 넣지 않습니다. 실행 파일이 있는 폴더를 확인한 뒤에만 다음 단계를 진행합니다.

where.exe git
Get-Command git -All

5. 설치 프로그램의 PATH 선택 확인

공식 Git for Windows 설치 프로그램에는 Git Bash 전용과 일반 명령줄 사용 범위가 구분되어 있습니다. PowerShell과 편집기의 Git 연동을 사용할 계획이라면 명령줄과 타사 소프트웨어에서도 호출 가능한 옵션을 확인해 설치 설정을 조정합니다. 다른 셸 도구를 Windows PATH에 광범위하게 추가하는 옵션까지 꼭 필요한 것은 아니므로 각 선택의 설명을 읽으세요.

6. 변경 후 확인과 복구

설정이 적용되면 새 PowerShell에서 where.exe git과 git --version을 다시 실행합니다. 예상한 설치 위치와 버전이 확인되면 같은 편집기를 다시 시작해 소스 제어 기능이 Git을 찾는지도 살펴봅니다. 환경 변수를 직접 변경해야 하는 경우에는 기존 내용을 먼저 보관하고 확인한 경로 하나만 수정합니다. PATH 전체를 교체하거나 오래된 경로를 무작정 삭제하면 다른 개발 도구에 영향을 줄 수 있습니다. 직접 바꾼 설정이 문제를 만들면 보관한 원래 PATH 항목으로 되돌린 뒤 새 셸에서 확인합니다. 설치 폴더 안의 git.exe를 전체 경로로 실행했을 때만 버전이 나온다면 파일 자체보다 명령 검색 경로를 점검할 근거가 됩니다.

7. 담당자에게 전달할 진단 자료

조직 정책 때문에 설치나 환경 변수 변경이 제한되면 사용자 권한을 높여 반복하기 전에 담당자에게 요청합니다. 사용한 패키지 이름, Git Bash와 PowerShell에서 각각의 결과, where.exe git의 필요한 부분, 오류가 나타난 편집기를 정리하면 설치 문제와 셸 문제를 구분하기 쉽습니다. PATH 안의 개인 폴더와 내부 공유 경로는 공개 화면에서 가리고, 토큰이나 원격 저장소 암호는 포함하지 않습니다.

함께 확인할 설치·오류 해결

Windows · 입문 · 8개 항목VS Code 설치와 한국어 메뉴 설정

내 계정에 편집기를 설치한 다음 메뉴를 한국어로 바꾸고, 작업 폴더에서 편집기를 여는 방법을 확인합니다.

Windows · 입문 · 7개 항목VS Code 설치 후 code 명령을 찾을 수 없을 때

시작 메뉴에서 편집기는 열리지만 PowerShell이나 명령 프롬프트에서 code를 인식하지 못하는 경우를 다룹니다.

Windows · 입문 · 8개 항목Windows에 Git 설치하고 작성자 정보 설정하기

Git Bash에서 설치 상태를 확인하고 커밋에 남길 이름과 이메일이 어느 저장소에 적용되는지 점검합니다.

공식 출처

공식 자료 확인일 2026-11-01