VS Code 실행 안됨 원인+해결 가이드: Windows에서 프로세스 종료 · 확장 비활성화 · GPU 문제까지

최신 업데이트: · 적용 대상: Windows 10/11 · 난이도: 초급~중급

🔧 빠른 해결 요약

주요 원인: 확장 프로그램 충돌, 사용자 데이터 손상, GPU 렌더링 문제

해결 순서: 프로세스 정리 → 확장 비활성화 실행 → 새 프로필 테스트 → GPU 비활성화 → 데이터 초기화 → 재설치

VS Code 아이콘을 클릭해도 아무 반응이 없거나, 잠깐 떴다가 사라지는 경우가 있습니다. 이런 문제는 대부분 확장 프로그램 충돌, 설정 파일 손상, 그래픽 렌더링 오류 때문입니다.

이 가이드는 데이터 손실 없이 원인을 찾아 해결하는 방법을 제시합니다. 각 방법을 순서대로 따라하시면 대부분 해결할 수 있습니다.

🔍 이런 증상이 나타나나요?

  • VS Code 아이콘 더블클릭 시 아무 반응 없음
  • 작업 관리자에 Code.exe가 잠시 나타났다가 사라짐
  • 빈 창이나 검은 화면만 뜨고 "응답 없음" 상태 지속
  • 확장 프로그램 업데이트 이후부터 실행 불가
  • Windows 업데이트나 드라이버 업데이트 후 문제 발생

위 증상 중 하나라도 해당되면 아래 방법들을 차례로 시도해보세요.

1️⃣ 백그라운드 프로세스 정리하기

숨어있는 VS Code 프로세스가 새 실행을 방해할 수 있습니다.

작업 관리자로 종료하기

  1. Ctrl + Shift + Esc로 작업 관리자 열기
  2. "프로세스" 탭에서 Code.exe 또는 Visual Studio Code 찾기
  3. 우클릭 → "작업 끝내기" 클릭
작업 관리자에서 Visual Studio Code 프로세스를 선택한 뒤 작업 끝내기 버튼을 누르면, 실행 중인 잔여 프로세스가 완전히 종료되어 VS Code를 정상적으로 다시 실행할 수 있습니다.

명령어로 한번에 종료하기

  1. Windows + Rcmd 입력 → 엔터
  2. 아래 명령어 입력 후 엔터
taskkill /IM Code.exe /F

이 방법으로 해결되었다면: 앞으로는 VS Code 종료 시 완전히 닫히도록 설정을 확인하세요.

2️⃣ 확장 비활성화로 실행하기

확장 프로그램이 충돌을 일으키는 경우가 가장 흔합니다. 모든 확장을 끈 상태로 실행해봅시다.

  1. Windows + Rcmd 또는 powershell 입력
  2. 아래 명령어 입력 후 엔터
code --disable-extensions

이 방법으로 해결되었다면:

  • 문제 확장을 찾기 위해 확장을 하나씩 활성화해보기
  • VS Code에서 Ctrl + Shift + X → 확장 관리
  • 최근 설치/업데이트된 확장부터 비활성화 테스트

공식 기능 활용

  • 임시 프로필: Command Palette → Profiles: Create a Temporary Profile 실행
  • 확장 이분 탐색: Command Palette → Help: Start Extension Bisect 실행

3️⃣ 새 프로필 테스트

설정이나 워크스페이스 데이터가 손상된 경우를 확인합니다.

code --user-data-dir "%TEMP%\vscode-clean"

이 명령은 임시 폴더에 완전히 새로운 VS Code 환경을 만듭니다.

  • 사용자 데이터: %APPDATA%\Code\
  • 확장 데이터: %USERPROFILE%\.vscode\extensions

4️⃣ GPU 가속 끄기 (빈 화면 해결)

그래픽 카드 드라이버와 충돌하여 빈 화면이나 먹통 상태가 될 수 있습니다.

임시로 GPU 가속 끄기

code --disable-gpu

영구적으로 GPU 가속 끄기

  1. Ctrl + Shift + PPreferences: Configure Runtime Arguments
  2. argv.json 열림 → 아래 추가
{
  "disable-hardware-acceleration": true
}

팁: 업데이트 직후 빈 화면이 계속 뜨면 %APPDATA%\Code\GPUCache 폴더를 삭제해보세요.

5️⃣ 사용자 데이터 초기화하기

⚠️ 주의사항: 개인 설정은 초기화되므로 백업 후 진행하세요.

백업 후 초기화 과정

  1. VS Code 완전 종료
  2. Windows + R%APPDATA% 입력
  3. Code 폴더를 Code.backup으로 이름 변경
  4. VS Code 다시 실행

6️⃣ 완전 재설치하기

일반 재설치

  1. 제어판 → 프로그램 추가/제거에서 VS Code 제거
  2. VS Code 공식 사이트에서 최신 버전 다운로드
  3. User Installer (개인용) 또는 System Installer (전체 사용자용) 선택
  4. 설치 후 재시작

포터블 모드 (Portable Mode)

  1. 공식 사이트에서 ZIP 버전 다운로드
  2. 압축 해제 후 루트에 data 폴더 생성
  3. Code.exe 실행 → 모든 설정/확장 data 폴더에 저장

✅ 최종 점검사항

  • --disable-extensions 실행 가능 → 문제 확장 비활성화/제거
  • --user-data-dir 실행 가능 → 사용자 데이터 초기화 필요
  • --disable-gpu 실행 가능 → argv.json에 영구 적용
  • ZIP 포터블 모드 실행 가능 → 기존 설치 문제 → 재설치
  • code --status로 진단 정보 확인 가능
  • PATH 문제 시 ...\Microsoft VS Code\bin을 수동 추가

❓ 자주 묻는 질문

Q1. 사용자 데이터 초기화하면 확장도 사라지나요?

A: 아니요. 확장은 %USERPROFILE%\.vscode\extensions에 별도로 저장됩니다.

Q2. 기업 환경(AppLocker)에서 실행이 막히는 경우?

A: argv.json"disable-chromium-sandbox": true를 추가하면 해결될 수 있으나, 보안 정책과 충돌할 수 있으므로 반드시 사내 IT 정책 확인 후 진행하세요.

댓글 쓰기

0 댓글