VS Code 터미널이 열리지 않음 5단계 실전 해결 가이드

VS Code 터미널이 열리지 않음 오류 원인과 핵심 요약

VS Code 터미널이 안 열리는 원인은 기본 셸 경로가 존재하지 않는 프로그램을 가리키는 경우가 가장 많고, 그다음이 설정 파일에 남은 옛 터미널 설정, PowerShell 실행 정책이 프로필 스크립트를 막는 경우, GPU 가속 렌더링 문제입니다. 터미널 패널에 뜨는 오류 문구 한 줄이 원인을 거의 정확히 알려주므로, 먼저 그 문구부터 확인하세요.

아래 명령 팔레트 명령은 영어 화면 기준입니다. 한국어 언어 팩을 쓰면 “터미널: 기본 프로필 선택”처럼 번역되어 표시되며, 명령 팔레트에 영어로 입력해도 검색됩니다.

---

증상별 바로가기

지금 상황	바로 갈 곳
Path to shell executable ... does not exist 오류가 뜬다	해결 방법 1
터미널이 열리자마자 닫히고 exit code 1이 뜬다	해결 방법 2
profile.ps1 파일을 로드할 수 없습니다가 뜬다	해결 방법 3
터미널 창이 까맣게 비어 있고 글자가 안 보인다	해결 방법 4
위 어디에도 해당하지 않거나 갑자기 안 된다	해결 방법 5

---

해결 방법 1: 기본 터미널 프로필 다시 고르기

Git Bash 같은 셸을 지웠는데 VS Code가 계속 그 셸을 기본으로 실행하려 할 때 나타납니다.

1. Ctrl + Shift + P를 눌러 명령 팔레트를 엽니다. 맥은 Command + Shift + P입니다.
2. Terminal: Select Default Profile을 입력해 선택합니다.
3. 목록에서 PowerShell(맥은 zsh)을 선택합니다.
4. 터미널 패널의 휴지통 아이콘을 눌러 기존 터미널을 모두 닫고, Ctrl + `로 새 터미널을 엽니다.
5. 원래 쓰던 셸로 돌아가고 싶다면 그 셸을 다시 설치한 뒤 같은 방법으로 선택합니다.

---

해결 방법 2: 설정 파일의 옛 터미널 설정 지우기

1. 명령 팔레트에서 Preferences: Open User Settings (JSON)을 선택해 사용자 설정 파일을 엽니다.
2. terminal.integrated.shell.windows, terminal.integrated.shellArgs.windows처럼 shell이 들어간 줄이 있는지 찾습니다. 이 방식은 예전 설정 형식이라 현재 버전에서는 충돌을 일으킬 수 있습니다.
3. 해당 줄을 지우거나, 줄 앞에 //를 붙여 주석으로 만듭니다.
4. terminal.integrated.profiles.windows나 terminal.integrated.defaultProfile.windows 항목이 있다면 그 안의 경로가 실제로 존재하는지 확인합니다.
5. 파일을 저장하고 VS Code를 완전히 종료했다가 다시 실행합니다.

설정 파일을 고치기 전에 내용을 전부 복사해 메모장 등에 백업해 두세요. 쉼표 하나만 잘못 지워도 설정 전체가 읽히지 않습니다. VS Code는 문법 오류가 있는 줄에 빨간 밑줄을 표시하므로 저장 전에 확인하세요.

---

해결 방법 3: PowerShell 실행 정책 확인

터미널은 열리는데 빨간 오류와 함께 profile.ps1을 로드할 수 없다는 메시지가 나오는 경우입니다.

1. 현재 실행 정책을 확인합니다. VS Code 밖의 PowerShell 창에서 실행해도 됩니다.

   Get-ExecutionPolicy -List

2. CurrentUser 항목이 Undefined이거나 Restricted라면 내 계정 범위에서만 정책을 바꿉니다.

   Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

3. 확인을 묻으면 Y를 입력합니다.

4. VS Code 터미널을 새로 열어 오류가 사라졌는지 확인합니다.

회사 PC는 실행 정책을 그룹 정책으로 고정해 두는 경우가 있습니다. 위 명령이 거부되면 임의로 우회하지 말고 IT 담당자에게 문의하세요.

---

해결 방법 4: GPU 가속 끄기

터미널 창은 열려 있는데 까맣게 비어 있거나 글자가 깨져 보이는 경우입니다.

1. 명령 팔레트에서 Preferences: Open User Settings (JSON)을 엽니다.

2. 중괄호 안에 아래 줄을 추가합니다. 앞 줄 끝에 쉼표가 있는지 확인하세요.

   "terminal.integrated.gpuAcceleration": "off"

3. 저장하고 VS Code를 다시 실행합니다.

4. 해결되면 그래픽 드라이버를 최신으로 업데이트한 뒤 이 줄을 지워 다시 켜볼 수 있습니다.

---

해결 방법 5: 확장 프로그램과 실행 환경 점검

1. 확장 프로그램을 모두 끈 상태로 VS Code를 실행해봅니다. 일반 PowerShell 창에서 실행합니다.

   code --disable-extensions

2. 이 상태에서 터미널이 열리면 확장 프로그램 중 하나가 원인입니다. 최근 설치한 터미널·셸 관련 확장부터 하나씩 꺼서 찾습니다.

3. 바탕화면의 VS Code 아이콘을 마우스 오른쪽 버튼으로 클릭하고 속성 > 호환성 탭을 엽니다. 호환 모드나 관리자 권한으로 이 프로그램 실행이 체크되어 있다면 해제합니다. 이 옵션들이 터미널 실행을 막는 사례가 있습니다.

4. 백신 프로그램이 VS Code가 셸을 실행하는 것을 차단하지 않는지 확인합니다. 차단 기록에 VS Code가 있으면 예외로 등록합니다.

5. 그래도 안 되면 VS Code를 최신 버전으로 재설치합니다. 설정과 확장은 사용자 폴더에 따로 저장되어 재설치로 지워지지 않습니다.

---

문제 해결이 안 될 경우 추가 점검 사항

• 원격·WSL 연결 중: 원격 SSH나 WSL에 연결된 창이라면 터미널은 원격 쪽 셸을 실행합니다. 원격 환경의 셸 설정이나 연결 상태를 확인하세요.
• 작업 영역 설정: 특정 폴더를 열었을 때만 안 된다면 그 폴더의 .vscode/settings.json에 터미널 설정이 들어 있는지 확인하세요.
• 사용자 이름에 한글이나 공백: 윈도우 사용자 폴더 경로에 한글이나 공백이 있으면 일부 셸과 도구가 경로를 잘못 읽는 경우가 있습니다.
• 기본 PowerShell 자체 확인: VS Code 밖에서 PowerShell을 직접 실행해 정상 동작하는지 먼저 확인하세요. 거기서도 안 되면 VS Code가 아니라 윈도우 쪽 문제입니다.
• 출력 패널 로그: [보기 > 출력] 패널에서 오른쪽 목록을 Terminal 계열로 바꾸면 더 자세한 오류 기록을 볼 수 있습니다.