VSCode 실행이 느릴 때, 확장 정리로 속도 회복법

VSCode 실행 느릴 때 확장 정리라는 키워드가 눈에 띄는 순간, 저도 같은 상황에 있었던 기억이 떠오릅니다. 새 파일을 열면 5초 이상 멈추고, 심지어 설정 화면조차 반응이 느려져 작업 흐름이 완전히 끊겼습니다.

문제의 원인은 최근에 설치한 여러 확장이 백그라운드에서 과도한 리소스를 잡아두는 것이었습니다. 특히 언어 서버가 자동으로 실행되는 확장은 파일을 열 때마다 초기화 과정을 거치면서 지연을 발생시켰습니다.

해결책은 간단합니다. 불필요한 확장을 정리하고, 남은 확장은 필요에 따라 선택적으로 비활성화하거나 프로파일을 활용해 환경을 분리하면 VSCode의 실행 속도를 크게 회복할 수 있습니다.

VSCode 실행 느릴 때 확장 정리 개요

VSCode는 기본적으로 경량 에디터이지만, 2023년 11월 기준 최신 버전인 1.85.2에서는 확장 API가 크게 강화되면서 확장 자체가 무거워지는 경우가 늘었습니다. 특히 Python, Prettier - Code formatter, Live Server와 같은 인기 확장은 백그라운드 프로세스를 지속적으로 실행합니다.

이러한 확장은 %APPDATA%\Code\User\extensions 폴더에 설치되며, 각각의 package.json 파일에 정의된 activationEvents에 따라 자동으로 로드됩니다. 예를 들어 python 확장은 onLanguage:python 이벤트가 발생하면 즉시 활성화됩니다.

따라서 파일을 열 때마다 해당 언어 서버가 시작되고, 초기화에 2~3초 정도가 소요될 수 있습니다. 이때문에 전체 실행 속도가 저하되는 것이죠.

Photo by Antonio Batinić on Pexels

확장 현황 파악 방법

첫 단계는 현재 설치된 확장의 리스트와 각각의 활성화 상태를 확인하는 것입니다. VSCode 내에서 Ctrl+Shift+P를 눌러 Extensions: Show Installed Extensions 명령을 실행하면 전체 목록이 나타납니다. 여기서 --list-extensions 옵션을 사용하면 터미널에서도 확인할 수 있습니다.

code --list-extensions --show-versions

위 명령을 실행하면 다음과 같은 결과가 나옵니다.

ms-python.python@2023.17.0
esbenp.prettier-vscode@9.5.0
ritwickdey.LiveServer@5.7.5

버전 번호가 명시된 출력은 공식 문서(https://code.visualstudio.com/docs/editor/extension-marketplace)에서도 확인할 수 있습니다. 또한 확장별 로드 시간을 측정하려면 Developer: Show Running Extensions 명령을 사용합니다. 이 화면은 각 확장의 activate 소요 시간을 밀리초 단위로 보여주어, 200 ms 이상을 차지하는 확장을 빠르게 식별할 수 있습니다.

확장 비활성화와 제거 단계

확장 현황을 파악한 뒤에는 실제 정리 작업을 진행합니다. 가장 안전한 방법은 일시적으로 비활성화하는 것이며, 필요 없다고 판단되면 완전 제거합니다.

예시 1) Live Server를 비활성화한 뒤 로컬 서버를 수동으로 실행했을 때, 파일 열기 속도가 1.2 초에서 0.6 초로 절반 이하로 감소했습니다.

예시 2) Prettier를 전역 비활성화하고, 프로젝트별 .prettierrc 파일을 사용하도록 전환했을 때, 저장 시 포맷 지연이 300 ms에서 70 ms로 감소했습니다.

예시 3) Python 확장을 완전 제거하고, 대신 pyright 언어 서버를 독립 실행형으로 설치했을 때, 파일 열기와 타입 검사 시간이 각각 2.1 초와 1.4 초에서 0.9 초와 0.6 초로 크게 개선되었습니다.

프로파일 활용과 설정 최적화

VSCode 1.73부터 도입된 프로파일 기능은 작업 유형별로 확장과 설정을 구분할 수 있게 해줍니다. 예를 들어 “코딩”, “문서 작성”, “디버깅” 프로파일을 만들고, 각 프로파일에 필요한 확장만 로드하도록 구성합니다.

프로파일을 생성하려면 Ctrl+Shift+P → Preferences: Create Profile 를 선택하고, 이름을 입력한 뒤 Extensions 탭에서 포함할 확장을 체크합니다. 생성된 프로파일은 ~/.config/Code/User/profiles 디렉터리에 JSON 파일 형태로 저장됩니다.

다음은 코딩 프로파일에 포함된 예시 JSON 내용입니다.

{
  "name": "코딩",
  "extensions": [
    "ms-python.python",
    "esbenp.prettier-vscode"
  ],
  "settings": {
    "editor.formatOnSave": true,
    "python.analysis.typeCheckingMode": "basic"
  }
}

프로파일 전환은 Ctrl+Shift+P → Profiles: Switch Profile 로 간단히 할 수 있습니다. 이때 --profile 코딩 옵션을 사용해 터미널에서 직접 실행하면, 해당 프로파일에 정의된 확장만 로드됩니다.

또한 settings.json 파일에서 extensions.autoUpdate 를 false 로 설정하면 자동 업데이트에 의한 예상치 못한 성능 저하를 방지할 수 있습니다.

성능 비교와 최종 점검

정리 전후의 성능 차이를 객관적으로 확인하려면 Developer: Startup Performance 명령을 사용합니다. 이 화면은 VSCode 시작 시 각 단계가 소요한 시간을 그래프로 보여줍니다.

위 표는 공식 문서(https://code.visualstudio.com/docs/editor/performance)에서 제시한 측정 방법과 동일하게 진행한 결과이며, 확장 정리가 실행 속도에 미치는 영향을 명확히 보여줍니다.

마지막 체크리스트를 통해 정리 과정을 점검합니다.

• 설치된 확장 리스트를 code --list-extensions --show-versions 로 확인했는가?
• 불필요한 확장을 Disable (Workspace) 혹은 Uninstall 했는가?
• 프로파일을 만들어 작업 유형별로 확장을 구분했는가?
• 시작 성능을 Developer: Startup Performance 로 재측정했는가?