여러 프로젝트 동시 작업—VSCode 워크스페이스 자동 전환 설정 정리

여러 프로젝트를 동시에 열었는데 파일 경로가 뒤섞여 작업이 멈춘 상황, 이를 해결하는 핵심이 바로 VSCode 워크스페이스 자동 전환 설정입니다. 서로 다른 루트 경로를 가진 프로젝트들이 탐색기 하나에 뒤죽박죽으로 섞이면, 파일을 저장할 때나 모듈을 임포트할 때 경로 실수가 발생하여 작업 속도가 급격히 느려집니다. 이 문제는 VSCode가 기본적으로 단일 폴더 기반의 작업 환경을 전제하기 때문에, 여러 폴더를 병렬로 다룰 때 컨텍스트가 분리되지 않아 발생합니다. 이 글에서는 워크스페이스 파일의 구조를 분석하고 확장 프로그램과 단축키를 결합하여, 클릭 한 번으로 필요한 프로젝트 환경만 즉시 불러오는 VSCode 워크스페이스 자동 전환 설정 방법을 구체적으로 정리합니다.

함께 보면 좋은 글: 터미널 명령어 헷갈릴 때 — 맥 터미널 추천 5가지 정

VSCode 워크스페이스 자동 전환 설정은 단순히 폴더를 여는 것을 넘어, 해당 프로젝트에 맞는 확장 프로그램, 설정 값, 터미널 경로를 하나의 세트로 관리하는 기술입니다. 예를 들어 프런트엔드 프로젝트에서는 ESLint와 Prettier 설정이 적용된 상태로, 백엔드 프로젝트에서는 Python linting 도구가 활성화된 상태로 창이 분리되어야 합니다. 이를 구현하기 위해 VSCode의 기본 기능인 '.code-workspace' 파일 활용법부터 'Project Manager' 확장 프로그램의 고급 설정까지 단계별로 다룹니다.

VSCode 워크스페이스의 기본 원리와 구조

VSCode에서 워크스페이스는 단순히 열린 폴더의 목록이 아닌, 현재 작업 상태를 저장하는 JSON 형식의 설정 파일입니다. 일반적으로 VSCode를 실행하고 Ctrl+K Ctrl+O를 눌러 폴더를 열면 '단일 폴더 모드'로 실행됩니다. 이때는 설정이 사용자 전체 글로벌 설정(settings.json)을 따르지만, 워크스페이스로 저장하면 해당 폴더에만 적용되는 지역 설정을 생성할 수 있습니다.

VSCode 워크스페이스의 핵심은 '멀티 루트 워크스페이스(Multi-root Workspace)' 기능입니다. 이는 하나의 VSCode 창에 물리적으로 분리된 여러 폴더를 포함시킬 수 있는 기능으로, 프런트엔드와 백엔드 소스 코드가 서로 다른 깃허브 레포지토리에 존재하더라도 하나의 화면에서 통합 관리하는 데 최적화된 방법입니다. 이 구조를 이해하는 것이 자동화의 첫걸음입니다.

워크스페이스 파일(.code-workspace)은 기본적으로 프로젝트의 최상위 경로나 사용자가 지정한 위치에 저장됩니다. 이 파일 내부에는 folders 배열과 settings 객체가 포함됩니다. folders는 이 워크스페이스에 포함될 폴더들의 경로를 정의하고, settings는 이 워크스페이스에 한정하여 적용될 VSCode 환경 설정을 오버라이드(override)합니다. 즉, 글로벌 설정과 충돌하지 않으면서 프로젝트별로 맞춤형 환경을 구축할 수 있는 것입니다.

또한, 워크스페이스 설정의 우선순위를 이해하는 것이 중요합니다. VSCode는 설정을 적용할 때 '기본값 < 사용자 설정 < 원격 설정 < 워크스페이스 설정'의 순서로 우선순위를 적용합니다. 따라서 워크스페이스 설정에 특정 값을 명시하면, 사용자의 개별 설정보다 이 값이 우선시됩니다. 이를 이용하면 특정 프로젝트에서만 탭 크기를 2칸으로 변경하거나, 특정 확장 프로그램을 비활성화하는 등의 세밀한 제어가 가능해집니다. 예를 들어, 파이썬 프로젝트 워크스페이스에서는 Python 확장 프로그램의 linting을 끄고, Node.js 프로젝트에서는 ESLint를 강제로 활성화하는 식의 설정이 가능합니다.

Photo by Daniil Komov on Pexels

VSCode 워크스페이스 자동 전환 설정: 기본 기능 활용법

VSCode의 기본 기능만으로도 충분히 강력한 워크스페이스 자동 전환 환경을 구축할 수 있습니다. 이 과정은 별도의 확장 프로그램 없이 JSON 파일을 직접 생성하고 관리함으로써 VSCode의 가볍고 빠른 성능을 그대로 활용한다는 장점이 있습니다. 기본 기능을 활용한 설정은 크게 워크스페이스 파일 생성, 설정 분리, 그리고 단축키 연결의 3단계로 나뉩니다.

1단계: 멀티 루트 워크스페이스 파일 생성
먼저 VSCode를 실행하고 File > Save Workspace As...를 클릭합니다. 현재 열려 있는 폴더가 없다면 Ctrl+K Ctrl+O를 사용하여 메인이 될 폴더를 먼저 엽니다. 저장 대화상자가 나타나면 프로젝트를 식별하기 쉬운 이름(예: my-fullstack-app.code-workspace)으로 저장합니다. 이제 이 파일을 더블 클릭하기만 하면 지정된 폴더 구조로 VSCode가 실행됩니다. 추가로 폴더를 포함하고 싶다면 탐색기 상단의 폴더 아이콘을 클릭하여 Add Folder to Workspace...를 선택해 여러 폴더를 하나의 워크스페이스에 통합합니다.

2단계: 워크스페이스별 고유 설정 적용
생성된 워크스페이스 파일을 텍스트 에디터(혹은 VSCode 자신)로 열면 JSON 구조를 확인할 수 있습니다. 여기서 "settings" 항목을 추가하여 이 워크스페이스에만 적용될 규칙을 정의합니다. 예를 들어, 이 프로젝트는 탭 크기를 2로 사용하고 파일 저장 시 자동으로 포맷팅을 하도록 설정할 수 있습니다.

{
  "folders": [
    {
      "path": "../frontend"
    },
    {
      "path": "../backend"
    }
  ],
  "settings": {
    "editor.tabSize": 2,
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  }
}

이렇게 설정하면, 동일한 사용자 설정을 사용하는 다른 프로젝트에는 영향을 주지 않으면서도 이 워크스페이스에서만 코드 포맷팅과 탭 간격이 자동으로 조정됩니다. 또한, 특정 확장 프로그램이 이 프로젝트에서만 필요하다면 extensions.ignoreRecommendations 등의 설정을 통해 확장 프로그램의 활성화 상태도 제어할 수 있습니다.

3단계: 작업 보호 및 즐겨찾기 등록
워크스페이스 설정이 완료되었다면, 이를 OS 레벨에서 즉시 접근할 수 있도록 만들어야 '자동 전환'의 이점을 살릴 수 있습니다. 생성된 .code-workspace 파일의 바로가기를 만들어 작업 표시줄이나 바탕화면에 고정하세요. 이제 일반적인 VSCode 아이콘 대신 이 바로가기를 클릭하면 설정된 환경 그대로 작업을 시작할 수 있습니다. 윈도우의 경우 '시작 메뉴'에 고정하거나, 맥의 경우 Dock에 추가하여 두드러지게 배치하면 마우스나 터치 한 번으로 컨텍스트 전환이 가능합니다.

4단계: 터미널 경로 자동 설정
멀티 루트 워크스페이스를 사용할 때 가장 불편한 점 중 하나는 터미널이 열릴 때 기본 경로가 어디로 잡히느냐입니다. VSCode는 기본적으로 워크스페이스의 첫 번째 폴더를 기준으로 터미널을 엽니다. 하지만 settings.json에 "terminal.integrated.cwd" 설정을 추가하여 원하는 폴더를 기본 경로로 지정할 수 있습니다. 여러 개의 터미널을 사용한다면, 각 터미널 프로필(예: Git Bash, PowerShell)마다 별도의 경로를 설정하여 스크립트를 실행할 때마다 cd 명령어를 입력하는 번거로움을 없앨 수 있습니다.

5단계: 작업 영역(복원) 및 테스트
설정을 마친 후 VSCode를 완전히 종료하고 방금 저장한 워크스페이스 파일을 다시 실행해 봅니다. 탭의 크기, 포맷터, 터미널 경로, 열려 있던 파일들의 위치 등이 의도한 대로 복원되는지 확인합니다. 만약 특정 설정이 적용되지 않는다면, 설정의 우선순위를 점검해 보세요. 사용자 설정(