Visual Studio Code (VS Code)를 사용하다 보면 갑자기 터미널이 작동하지 않으면서 “The terminal process terminated with exit code 1” 오류 메시지가 나타나는 경우가 있습니다. 이 문제는 다양한 원인으로 발생할 수 있지만, 대부분 몇 가지 간단한 해결책으로 문제를 해결할 수 있습니다.
1. 안티바이러스 소프트웨어 문제 해결
가장 흔한 원인 중 하나는 안티바이러스 소프트웨어가 VS Code의 터미널 프로세스를 차단하는 것입니다.
해결 방법
- VS Code 설치 폴더 화이트리스트 추가
- Windows Defender: 설정 → 바이러스 및 위협 방지 → 제외 추가
- VS Code 설치 경로 (기본:
C:\Users\[사용자명]\AppData\Local\Programs\Microsoft VS Code) 추가
- 특정 파일들 예외 처리 다음 파일들을 안티바이러스 예외 목록에 추가:
{VS Code 설치경로}\resources\app\node_modules.asar.unpacked\node-pty\build\Release\winpty.dll {VS Code 설치경로}\resources\app\node_modules.asar.unpacked\node-pty\build\Release\winpty-agent.exe {VS Code 설치경로}\resources\app\node_modules.asar.unpacked\node-pty\build\Release\conpty.node
백신별 설정경로
| 안티바이러스 소프트웨어 | 설정 경로 |
|---|---|
| Windows Defender | 설정 → 바이러스 및 위협 방지 → 제외 추가 |
| Malware Bytes | 설정 → 제외 → 폴더 제외 추가 |
| Norton | 설정 → 안티바이러스 → 스캔 및 위험 요소 → 제외/낮은 위험 |
| Avast | 설정 → 일반 → 예외 |
2. Legacy Console 모드 비활성화
Windows의 Legacy Console 모드가 활성화되어 있으면 VS Code 터미널이 제대로 작동하지 않을 수 있습니다.
해결 방법
- 시작 메뉴에서
cmd검색 - 명령 프롬프트 우클릭 → 관리자 권한으로 실행
- 창 제목 표시줄 우클릭 → 속성
- 옵션 탭에서 “레거시 콘솔 사용” 체크 해제
- 확인 클릭 후 VS Code 재시작
3. PowerShell 실행 정책 변경
PowerShell의 실행 정책이 제한적으로 설정되어 있을 때 발생할 수 있습니다.
해결 방법
- PowerShell을 관리자 권한으로 실행
- 다음 명령어 입력:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine - 확인 메시지에서 Y 입력
4. VS Code 터미널 설정 재구성
터미널 설정이 잘못되었을 때는 기본 설정으로 재구성하는 것이 효과적입니다.
해결 방법
- Ctrl + Shift + P로 명령 팔레트 열기
- “Terminal: Select Default Profile” 검색 후 선택
- PowerShell 또는 Command Prompt 선택
- settings.json 수정 (필요한 경우):
{ "terminal.integrated.defaultProfile.windows": "PowerShell", "terminal.integrated.profiles.windows": { "PowerShell": { "source": "PowerShell", "icon": "terminal-powershell" } }}
5. 권한 및 관리자 모드 문제
일부 환경에서는 권한 부족으로 인해 터미널이 실행되지 않을 수 있습니다.
해결 방법
- VS Code를 관리자 권한으로 실행
- VS Code 아이콘 우클릭 → 관리자 권한으로 실행
- PowerShell 관리자 권한 설정 해제
- PowerShell 실행파일 속성에서 “관리자 권한으로 실행” 옵션 해제
6. 특수문자 경로 문제 해결
프로젝트 폴더 경로에 한글이나 특수문자가 포함되어 있으면 터미널 오류가 발생할 수 있습니다.
해결 방법
- 프로젝트 폴더명을 영문으로 변경
- 프로젝트를 영문 경로로 이동
- 작업 공간을 다시 열기
예시:
변경 전: C:\프로젝트\웹개발\내사이트
변경 후: C:\Projects\WebDev\MySite
7. 실행 중인 프로세스 충돌 해결
다른 프로세스가 터미널을 점유하고 있을 때 발생할 수 있습니다.
해결 방법
- 작업 관리자 열기 (Ctrl + Shift + Esc)
- 세부 정보 탭에서 다음 프로세스들 종료:
powershell.execmd.exenode.exe(실행 중인 경우)
- VS Code 재시작
8. WSL(Windows Subsystem for Linux) 설정 확인
WSL을 사용하는 환경에서는 WSL 설정 문제로 인해 오류가 발생할 수 있습니다.
해결 방법
- PowerShell에서 WSL 상태 확인:
wslconfig.exe /l - 기본 배포판 설정:
wslconfig.exe /setdefault "Ubuntu" - WSL 업데이트:
wsl --update
9. VS Code 완전 재설치
위의 방법들로도 해결되지 않는다면 완전 재설치를 고려해보세요.
해결 방법
- VS Code 제거
- 제어판 → 프로그램 제거
- 사용자 데이터 폴더 삭제:
%APPDATA%\Code%USERPROFILE%\.vscode - 최신 버전 다운로드 및 설치
- VS Code 공식 사이트에서 최신 버전 다운로드
“The terminal process terminated with exit code 1” 오류는 다양한 원인으로 발생하지만, 대부분의 경우 백신(안티바이러스 소프트웨어) 설정이나 Legacy Console 모드 문제로 인한 것입니다. 위에서 제시한 해결 방법들을 순서대로 시도해보시면 문제를 해결할 수 있을 것입니다.
문제가 지속된다면 VS Code의 공식 문서나 GitHub 이슈를 참조하거나, 커뮤니티에 도움을 요청하는 것도 좋은 방법입니다. 🙂