작업 공간 (Workspace)

작업 공간(Workspace)은 개발 도구에서 함께 열고 다룰 프로젝트 폴더와 작업 설정을 묶는 단위입니다. 검색 범위와 실행 작업, 편집 설정을 프로젝트에 맞게 관리하는 데 쓰입니다. 구체적인 경계는 도구마다 다르며, VS Code에서는 하나의 창에 연 폴더 하나 또는 여러 폴더의 모음을 작업 공간으로 다룹니다.

함께 여는 폴더의 범위

VS Code의 작업 공간 설명은 한 창에 연 하나 이상의 폴더를 작업 공간으로 정의합니다. 보통 프로젝트 폴더 하나를 열지만 서로 다른 폴더를 한 창에 묶는 다중 루트 구성도 지원합니다. 서버 코드와 별도의 공용 라이브러리를 함께 보며 작업하는 경우처럼, 실제 파일 위치를 옮기지 않고 편집할 범위를 구성하는 데 쓸 수 있습니다.

다중 루트 구성에서는 .code-workspace 파일이 포함할 폴더와 작업 공간 설정을 보관합니다. 이 파일이 있다고 모든 소스가 그 안에 복사되는 것은 아닙니다. 다른 컴퓨터에서 같은 구성을 열려면 참조하는 폴더가 실제로 존재하고 경로가 맞아야 합니다. 작업 공간 파일만 전달한 경우와 프로젝트의 원본 파일까지 전달한 경우를 구분하면 복구 과정의 누락을 찾기 쉽습니다.

작업 공간의 경계와 Git 저장소의 경계도 같다고 보장되지 않습니다. 한 작업 공간에 여러 저장소를 열 수 있고 저장소의 일부 폴더만 열 수도 있습니다. 편집기에서 보이는 파일 목록만으로 커밋 대상이 정해지는 것은 아닙니다. 변경을 저장소에 기록할 때는 실제 Git 루트와 현재 브랜치를 확인해 어느 프로젝트의 이력에 들어가는지 구분합니다.

사용자 설정과 프로젝트 설정

VS Code의 설정 문서는 여러 창에 적용하는 사용자 설정과 현재 프로젝트에 적용하는 작업 공간 설정을 나눕니다. 특정 프로젝트에서만 검색 제외나 편집 방식을 바꾸고 싶다면 작업 공간 수준의 설정을 사용할 수 있습니다. 같은 항목의 적용 범위가 겹칠 때 어떤 설정이 우선하는지도 확인해야 다른 프로젝트까지 바뀐 것처럼 보이는 혼동을 줄일 수 있습니다.

단일 폴더 작업 공간의 설정은 보통 .vscode/settings.json에 저장하며, 다중 루트 전체 설정은 .code-workspace 안에 둡니다. 공식 작업 공간 문서는 다중 루트에서 폴더별 설정이 전체 작업 공간 설정보다 우선한다고 설명합니다. 다만 모든 설정을 모든 범위에 둘 수 있는 것은 아니므로, 설정 항목이 지원하는 범위와 언어별 설정 같은 추가 조건도 함께 봅니다.

팀이 공유할 설정과 개인 환경에만 맞는 설정은 보관 목적이 다릅니다. 팀 전체에 필요한 실행 작업은 프로젝트 파일로 공유할 수 있지만 개인 컴퓨터의 절대 경로나 자격 증명을 그대로 넣으면 다른 환경에서 실패하거나 민감한 정보가 노출될 수 있습니다. 설정 파일도 코드와 함께 검토할 대상이며, 파일이 존재한다는 사실과 팀원 환경에서 그대로 실행된다는 사실은 별도로 확인합니다.

작업 공간 신뢰와 실행 환경

VS Code의 Workspace Trust 안내는 낯선 프로젝트를 Restricted Mode로 열어 자동 코드 실행을 제한하는 기능을 설명합니다. 이 상태에서는 작업 실행, 디버깅, 확장 기능 등 일부 기능이 제한될 수 있습니다. 파일을 읽기 위해 연 것과 그 프로젝트가 정의한 명령의 실행을 허용한 것은 서로 다른 선택입니다.

작업 공간을 신뢰한다고 코드가 검증되거나 별도의 격리 환경이 만들어지는 것은 아닙니다. 공식 안내도 악성 확장이 신뢰 제한을 무시하고 실행하는 것을 이 기능만으로 막을 수 없다고 설명합니다. 프로젝트의 설정과 실행 명령, 확장의 출처를 확인하는 일은 따로 남습니다. 어떤 기능이 제한됐는지 살피면 실행 실패가 코드 문제인지 편집기의 신뢰 상태 문제인지 구분하는 데 도움이 됩니다.

AI 코딩 도구를 사용할 때는 실제로 연 폴더와 명령을 실행하는 위치를 함께 확인합니다. 같은 이름의 프로젝트 복사본이 여럿 있으면 다른 폴더를 수정하고 원래 폴더에서 테스트할 수 있습니다. 작업 기록에 최상위 경로와 변경 파일, 실행 위치를 남기면 이 어긋남을 찾기 쉽습니다. 여러 폴더를 묶은 구성에서는 각 명령의 대상 폴더도 함께 지정합니다.