PowerShell '~용어가 인식되지 않습니다' 에러 원인과 해결

증상

PowerShell에서 명령어를 입력했더니 빨간 글씨로 이런 에러가 나옵니다.

gh : 'gh' 용어가 cmdlet, 함수, 스크립트 파일 또는 실행할 수 있는
프로그램 이름으로 인식되지 않습니다.
+ CategoryInfo : ObjectNotFound, CommandNotFoundException

원인은 셋 중 하나

1. 프로그램이 설치되어 있지 않음 (가장 흔함)

블로그나 문서에서 복사한 명령어가 별도 프로그램을 필요로 하는 경우입니다. 위 예시의 gh는 GitHub CLI라는 별도 도구라서, 설치하지 않았다면 당연히 인식되지 않습니다. 해결은 설치:

winget install GitHub.cli

설치 후에는 새 터미널 창을 열어야 인식됩니다(아래 3번 참고).

2. 명령어가 아닌 것을 입력함

URL이나 파일 경로만 붙여넣고 Enter를 치면 PowerShell은 그것을 실행할 프로그램 이름으로 해석합니다.

https://github.com/user/repo.git : 'https://...' 용어가 인식되지 않습니다

이 경우 앞에 실제 명령이 빠진 것입니다. 예를 들어 git 원격 저장소를 추가하려면 URL만이 아니라 git remote add origin <URL> 전체를 입력해야 합니다.

3. 설치는 됐지만 PATH에 없음

프로그램은 설치됐는데 PowerShell이 위치를 모르는 경우입니다. 확인 방법:

(Get-Command 프로그램이름).Source

에러가 나면 PATH 문제입니다. 대부분은 터미널을 완전히 닫고 새로 열면 해결됩니다. 설치 프로그램이 PATH를 수정해도 이미 열려 있던 터미널에는 반영되지 않기 때문입니다. 그래도 안 되면 프로그램 재설치 시 “Add to PATH” 옵션을 체크했는지 확인하세요.

진단 순서 요약

1. 입력한 것이 완전한 명령어인가? (URL/경로만 넣지 않았나)
2. 그 프로그램이 설치되어 있나? → winget install
3. 설치했다면 새 터미널을 열었나?