“Visual Studio Code 오류: 창이 예기치 않게 종료되었습니다” 오류는 VS Code가 실행되는 도중 또는 구동 시점에 갑자기 충돌할 때 발생합니다. 이 문제의 주된 원인은 대개 크로뮴 샌드박스(Chromium Sandbox)와의 충돌입니다. 샌드박스는 프로세스를 격리해 애플리케이션을 안전하게 보호하는 내장 보안 계층으로, 보안에는 필수적이지만 특정 시스템 환경에서는 오히려 불안정성을 유발해 예기치 않은 종료를 일으킬 수 있습니다.
그 외에도 가상 메모리(페이징 파일) 부족, 손상된 캐시 파일, 과도하게 설치된 확장 프로그램, 하드웨어 가속 충돌 등이 원인일 수 있습니다. 드물지만 VS Code 설치본 자체가 오래되었거나 손상된 경우에도 같은 현상이 나타날 수 있습니다.
아래에서 이 문제를 해결하는 검증된 5가지 방법을 단계별로 소개합니다.
1. --disable-chromium-sandbox 플래그로 VS Code 실행하기
크로뮴 샌드박스는 보안을 위해 VS Code의 시스템 리소스 접근을 제한합니다. 하지만 운영체제나 드라이버가 이 기능을 완전히 지원하지 못하면 초기화 과정에서 편집기가 충돌할 수 있습니다. --disable-chromium-sandbox 플래그와 함께 실행하면 이 제한을 우회해 샌드박스 없이 애플리케이션을 구동할 수 있습니다.
⚠️ 주의: 크로뮴 샌드박스를 비활성화하면 VS Code 프로세스를 격리하던 보안 계층이 약화됩니다. 따라서 이 방법은 문제 진단용 또는 임시 조치로만 사용하고, 가급적 OS와 드라이버를 최신 상태로 업데이트해 샌드박스가 활성화된 상태에서 정상 실행되도록 하는 것이 좋습니다.
- Visual Studio Code를 완전히 종료합니다.
- Win + R 키를 누르고 cmd를 입력한 후 Enter 키를 누릅니다.
- 아래 명령어를 입력하고 Enter 키를 누릅니다:
code --disable-chromium-sandbox
- VS Code가 충돌 없이 실행된다면 OS와 드라이버 업데이트를 먼저 시도하세요. 필요하다면 임시 방편으로 이 모드를 유지할 수도 있습니다.
2. 가상 메모리(페이징 파일) 늘리기
VS Code는 여러 프로세스, 확장 프로그램, 렌더링 구성 요소를 메모리에 불러옵니다. 물리적 RAM이 부족하면 Windows는 가상 메모리(페이징 파일)에 의존하는데, 이 할당량이 너무 작으면 VS Code가 예기치 않게 종료될 수 있습니다. 페이징 파일 크기를 늘리면 시작 시점에 충분한 메모리를 확보할 수 있습니다.
- Win + R 키를 누르고 sysdm.cpl을 입력한 뒤 Enter 키를 누릅니다.
- 고급 탭으로 이동한 후 성능 항목에서 설정을 클릭합니다.
- 성능 옵션 창에서 고급 탭을 선택하고, 가상 메모리 영역의 변경 버튼을 클릭합니다.
- 모든 드라이브에 대한 페이징 파일 크기 자동 관리 체크박스를 해제합니다.
- 시스템 드라이브(보통 C:)를 선택하고 사용자 지정 크기를 고른 뒤 값을 입력합니다.
- 처음 크기: 화면에 표시되는 권장 값을 사용합니다.
- 최대 크기: 더 큰 값으로 설정합니다 (예: 4096 MB 이상).
- 설정 → 확인을 차례로 클릭한 뒤 시스템을 재부팅합니다.
3. VS Code 캐시 및 백업 데이터 삭제하기
VS Code는 세션 캐시, 확장 프로그램 상태, 백업 데이터를 프로필 폴더에 저장합니다. 이 파일들이 업데이트 실패, 강제 종료, 설정 충돌 등으로 손상되면 편집기가 실행 시점에 크래시될 수 있습니다. 해당 캐시 폴더를 삭제하면 VS Code가 이를 새로 생성하면서 문제가 해결되는 경우가 많습니다.
- 모든 VS Code 창을 완전히 닫습니다.
- Win + R 키를 누르고 아래 경로를 입력한 후 Enter 키를 누릅니다:
%APPDATA%\Code
- 다음 하위 폴더들을 삭제합니다:
Cache CachedData Code Cache GPUCache
- VS Code를 다시 실행하고 문제가 해결되었는지 확인합니다.
4. 확장 프로그램 및 하드웨어 가속 비활성화하기
하드웨어 가속은 렌더링 작업을 GPU에 위임해 성능을 높여주지만, GPU 드라이버가 불안정하면 충돌을 일으킬 수 있습니다. 마찬가지로 확장 프로그램은 VS Code의 동작을 직접 변경하므로, 결함이 있거나 호환되지 않는 확장이 편집기 실행 자체를 막을 수도 있습니다. 두 기능을 모두 끄고 실행하면 근본 원인을 좁혀가는 데 큰 도움이 됩니다.
4.1 확장 프로그램 비활성화
- Win + R 키를 누르고 cmd를 입력한 후 Enter 키를 누릅니다.
- 아래 명령어를 실행합니다:
code --disable-extensions
- VS Code가 정상적으로 열린다면 설치된 확장 중 하나가 원인입니다. 확장을 하나씩 다시 활성화하며 문제가 되는 항목을 찾아내세요.
4.2 하드웨어 가속 비활성화
- Ctrl+Shift+P를 눌러 명령 팔레트(Command Palette)를 엽니다.
- Preferences: Open Settings (JSON)을 검색해 선택합니다.
- JSON 파일에 다음 줄을 추가합니다:
"disable-hardware-acceleration": true
- VS Code를 재시작합니다. 이후에는 GPU 대신 CPU 렌더링을 사용하게 됩니다.
5. Visual Studio Code 재설치하기
위 방법으로도 해결되지 않는다면 VS Code를 재설치하는 것이 가장 확실한 선택입니다. 손상된 핵심 파일이나 불완전한 설치를 새 복사본으로 교체하여 설치 단계에서 발생한 문제를 완전히 배제할 수 있습니다.
- Win + R 키를 누르고 appwiz.cpl을 입력한 후 Enter 키를 누릅니다.
- Visual Studio Code를 찾아 마우스 오른쪽 버튼으로 클릭한 뒤 제거를 선택합니다.
- VS Code 공식 웹사이트(code.visualstudio.com)에서 최신 버전을 다운로드합니다.
- 설치 프로그램을 실행해 설치를 완료합니다.
- VS Code를 실행하여 오류가 해결되었는지 확인합니다.
마무리
VS Code의 '창이 예기치 않게 종료됨' 오류는 대부분 샌드박스 충돌, 메모리 부족, 캐시 손상, 확장 프로그램 문제 중 하나에서 비롯됩니다. 위 방법들을 순서대로 적용하면 대부분의 경우 문제를 해결할 수 있으며, 재설치까지 진행하면 사실상 모든 설치 관련 원인을 제거할 수 있습니다.
저자 소개

Hamza Mohammad Anwar
함자 무함마드 안와르(Hamza Mohammad Anwar)는 MERN 스택 기술을 활용해 고성능 웹 애플리케이션을 개발하는 JavaScript 웹 개발자입니다. ReactJS, MongoDB, Express, Node.js 등 관련 기술에 전문성을 갖추고 있으며, Google IT 인증 전문가 자격도 보유하고 있습니다. 다양한 기술적 문제 해결을 즐기며, 실제 컴퓨터에서 오류를 직접 재현해 원인을 분석하고 해결책을 찾는 작업에 능숙합니다.