사용자 및 작업 영역 설정
Visual Studio Code를 다양한 설정을 통해 원하는 대로 구성할 수 있습니다. VS Code의 에디터, 사용자 인터페이스, 기능적 동작의 거의 모든 부분을 수정할 수 있는 옵션이 있습니다.
VS Code는 다음과 같은 설정 범위를 제공합니다:
- 사용자 설정 - 열려있는 모든 VS Code 인스턴스에 전역적으로 적용되는 설정.
- 작업 영역 설정 - 작업 영역 내에 저장되며 작업 영역이 열릴 때만 적용되는 설정.
VS Code는 설정 값을 settings JSON 파일에 저장합니다. settings JSON 파일을 직접 편집하거나 그래픽 인터페이스를 제공하는 설정 에디터를 사용하여 설정 값을 변경할 수 있습니다.
사용자 설정
사용자 설정은 VS Code를 사용자 정의하기 위한 개인 설정입니다. 이러한 설정은 열려있는 모든 VS Code 인스턴스에 전역적으로 적용됩니다. 예를 들어, 사용자 설정에서 에디터 글꼴 크기를 14로 설정하면 컴퓨터의 모든 VS Code 인스턴스에서 14로 적용됩니다.
다음과 같은 여러 가지 방법으로 사용자 설정에 접근할 수 있습니다:
- 명령 팔레트(
Ctrl+Shift+P
)에서 Open User Settings 명령 선택 - 설정 에디터(
Ctrl+,
)에서 User 탭 선택 - 명령 팔레트(
Ctrl+Shift+P
)에서 Preferences: Open User Settings (JSON) 명령 선택
작업 영역 설정
작업 영역 설정은 특정 프로젝트에 한정되며 사용자 설정을 재정의합니다. 특정 프로젝트에 적용하고 싶은 설정이 있다면 작업 영역 설정을 사용할 수 있습니다. 예를 들어, 백엔드 서버 프로젝트의 경우 files.exclude
설정을 사용하여 파일 탐색기에서 node_modules
폴더를 제외할 수 있습니다.
VS Code "작업 영역"은 일반적으로 프로젝트 루트 폴더입니다. 다중 루트 작업 영역이라는 기능을 통해 VS Code 작업 영역에 둘 이상의 루트 폴더를 가질 수도 있습니다. VS Code 작업 영역에 대해 자세히 알아보세요.
VS Code는 작업 영역 설정을 프로젝트 루트의 .vscode
폴더에 저장합니다. 이를 통해 버전 관리(예: Git)되는 프로젝트에서 다른 사람들과 설정을 쉽게 공유할 수 있습니다.
작업 영역 설정에 접근하는 방법은 다음과 같습니다:
- 명령 팔레트(
Ctrl+Shift+P
)에서 Preferences: Open Workspace Settings 명령 선택 - 설정 에디터(
Ctrl+,
)에서 Workspace 탭 선택 - 명령 팔레트(
Ctrl+Shift+P
)에서 Preferences: Open Workspace Settings (JSON) 명령 선택
모든 사용자 설정이 작업 영역 설정으로 사용 가능한 것은 아닙니다. 예를 들어, 업데이트와 보안 관련된 애플리케이션 전반의 설정은 작업 영역 설정으로 재정의할 수 없습니다.
설정 에디터
설정 에디터는 사용자 및 작업 영역 설정을 관리하기 위한 그래픽 인터페이스를 제공합니다. 설정 에디터를 열려면 File > Preferences > Settings으로 이동하세요. 또는 Command Palette(Ctrl+Shift+P
)에서 Preferences: Open Settings를 선택하거나 키보드 단축키(Ctrl+,
)를 사용할 수 있습니다.
설정 에디터를 열면 검색하고 원하는 설정을 찾을 수 있습니다. 검색 창을 사용하여 검색하면 설정 에디터는 검색 조건과 일치하는 설정만 표시하도록 필터링합니다. 이를 통해 빠르고 쉽게 설정을 찾을 수 있습니다.
VS Code는 설정을 변경하면 즉시 적용합니다. 수정한 설정은 에디터에서 수정된 줄과 유사하게 설정의 왼쪽에 있는 색상 막대로 식별할 수 있습니다.
아래 예시에서는 사이드 바 위치와 파일 아이콘 테마가 변경되었습니다.
설정 옆의 기어 아이콘(Shift+F9
)을 클릭하면 설정을 기본값으로 재설정하고, 설정 ID를 복사하고, JSON 이름-값 쌍을 복사하거나 설정 URL을 복사하는 옵션이 있는 컨텍스트 메뉴가 열립니다.
설정 URL을 사용하면 브라우저에서 설정 에디터의 특정 설정으로 직접 이동할 수 있습니다. URL 형식은 vscode://settings/<settingName>
이며, 여기서 <settingName>
은 이동하려는 설정의 ID입니다. 예를 들어, workbench.colorTheme
설정으로 이동하려면 URL vscode://settings/workbench.colorTheme
을 사용하세요.
설정 그룹
설정은 그룹으로 표시되어 관련 설정을 빠르게 탐색할 수 있습니다. 상단에는 자주 사용되는 사용자 지정 설정을 보여주는 Commonly Used 그룹이 있습니다.
다음 예시에서는 트리 화면에서 Source Control를 선택하여 소스 제어 설정에 초점을 맞추고 있습니다.
VS Code 확장도 자체 사용자 지정 설정을 추가할 수 있으며, 이러한 설정은 Extensions 섹션 아래에서 확인할 수 있습니다.
설정 에디터 필터
설정 에디터 검색 창에는 설정을 더 쉽게 관리할 수 있는 여러 필터가 있습니다. 검색 창 오른쪽에는 깔때기 아이콘이 있는 필터 버튼이 있어 검색 창에 필터를 쉽게 추가할 수 있는 옵션을 제공합니다.
수정된 설정
어떤 설정을 구성했는지 확인하려면 검색 창에 @modified
필터가 있습니다. 설정 값이 기본값과 다르거나 해당 settings JSON 파일에서 값이 명시적으로 설정된 경우 이 필터에 표시됩니다.
이 필터는 설정을 구성했는지 잊어버렸거나 실수로 설정을 구성하여 에디터가 예상대로 작동하지 않는 경우 유용할 수 있습니다.
기타 필터
설정을 검색하는 데 도움이 되는 여러 가지 유용한 필터가 있습니다. 검색 창에 @
기호를 입력하면 다양한 필터를 확인할 수 있습니다.
사용 가능한 필터 중 일부는 다음과 같습니다:
@ext
- 확장과 관련된 설정입니다. 예를 들어@ext:ms-python.python
과 같이 확장 ID를 제공합니다.@feature
- Features 하위 그룹과 관련된 설정입니다. 예를 들어@feature:explorer
는 파일 탐색기의 설정을 보여줍니다.@id
- 설정 ID를 기반으로 설정을 찾습니다. 예를 들어@id:workbench.activityBar.visible
.@lang
- 언어 ID를 기반으로 언어 필터를 적용합니다. 예를 들어@lang:typescript
. 자세한 내용은 언어별 에디터 설정을 참조하세요.@tag
- VS Code의 시스템과 관련된 설정입니다. 예를 들어 작업 영역 신뢰와 관련된 설정은@tag:workspaceTrust
, 접근성 관련 설정은@tag:accessibility
를 사용합니다.
검색 창은 설정 검색 쿼리를 기억하고 실행 취소/다시 실행(Ctrl+Z
/Ctrl+Y
)을 지원합니다. 검색 창 오른쪽에 있는 Clear Settings 버튼을 사용하여 검색어나 필터를 빠르게 지울 수 있습니다.
확장 설정
설치된 VS Code 확장도 자체 설정을 제공할 수 있으며, 이러한 설정은 설정 에디터의 Extensions 섹션에서 검토할 수 있습니다.
확장 뷰(Ctrl+Shift+X
)에서 확장을 선택하고 Feature Contributions 탭을 검토하여 확장의 설정을 검토할 수도 있습니다.
확장 작성자는 구성 기여 포인트 문서에서 사용자 정의 설정 추가에 대해 자세히 알아볼 수 있습니다.
설정 JSON 파일
VS Code는 설정 값을 settings.json
파일에 저장합니다. 설정 에디터는 settings.json
파일에 저장된 설정 값을 검토하고 수정할 수 있는 사용자 인터페이스입니다.
명령 팔레트(Ctrl+Shift+P
)에서 Preferences: Open User Settings (JSON) 또는 Preferences: Open Workspace Settings (JSON) 명령을 사용하여 에디터에서 직접 settings.json
파일을 검토하고 편집할 수도 있습니다.
설정 ID와 값을 지정하여 JSON으로 설정이 작성됩니다. 설정 에디터에서 설정의 기어 아이콘을 선택한 다음 Copy Setting as JSON 작업을 선택하여 해당 설정의 JSON 이름-값 쌍을 빠르게 복사할 수 있습니다.
settings.json
파일은 설정과 값에 대한 스마트 완성 및 설명 호버와 함께 완전한 IntelliSense를 제공합니다. 잘못된 설정 이름이나 JSON 형식으로 인한 오류도 강조 표시됩니다.
일부 설정은 Workbench: Color Customizations와 같이 settings.json
에서만 편집할 수 있으며 설정 에디터에서 Edit in settings.json 링크를 표시합니다.
항상 settings.json
으로 직접 작업하는 것을 선호한다면 workbench.settings.editor
를 json
으로 설정할 수 있습니다. 그러면 File > Preferences > Settings과 키보드 단축키 Ctrl+,
가 항상 설정 에디터 UI가 아닌 settings.json
파일을 엽니다.
설정 파일 위치
사용자 settings.json 위치
플랫폼에 따라 사용자 설정 파일 은 다음 위치에 있습니다:
- Windows
%APPDATA%\Code\User\settings.json
- macOS
$HOME/Library/Application\ Support/Code/User/settings.json
- Linux
$HOME/.config/Code/User/settings.json
작업 영역 settings.json 위치
작업 영역 설정 파일은 루트 폴더의 .vscode
폴더 아래에 있습니다. 작업 영역 설정 settings.json
파일을 프로젝트나 소스 제어에 추가하면 해당 프로젝트의 설정을 모든 사용자와 공유할 수 있습니다.
다중 루트 작업 영역의 경우, 작업 영역 설정은 작업 영역 구성 파일 내부에 있습니다.
설정 초기화
설정에 마우스를 올려 기어 아이콘을 표시한 다음, 기어 아이콘을 클릭하고 Reset Setting 작업을 선택하여 언제든지 설정을 기본값으로 재설정할 수 있습니다.
설정 에디터를 통해 개별 설정을 재설정할 수 있지만, settings.json
을 열고 중괄호 {}
사이의 항목을 삭제하여 모든 변경된 설정을 재설정할 수도 있습니다. 이전 설정 값을 복구할 방법이 없으므로 주의하세요.
언어별 에디터 설정
언어별 설정을 사용자 정의하는 한 가지 방법은 설정 에디터를 열고, 필터 버튼을 누른 다음, 언어 옵션을 선택하여 언어 필터를 추가하는 것입니다. 또는 검색 위젯에 @lang:languageId
형식의 언어 필터를 직접 입력할 수 있습니다. 표시되는 설정은 해당 특정 언어에 대해 구성 가능하며, 해당되는 경우 해당 언어에 특정한 설정 값을 보여줍니다.
언어 필터가 적용된 상태에서 설정을 수정하면, 해당 설정은 해당 언어에 대해 주어진 범위에서 구성됩니다.
예를 들어, 검색 위젯에 @lang:css
필터가 있는 상태에서 사용자 범위 diffEditor.codeLens
설정을 수정하면, 설정 에디터는 새 값을 사용자 설정 파일의 CSS 특정 섹션에 저장합니다.
검색 위젯에 둘 이상의 언어 필터를 입력하면, 현재는 첫 번째 언어 필터만 사용됩니다.
에디터를 언어별로 사용자 정의하는 또 다른 방법은 Command Palette(Ctrl+Shift+P
)에서 전역 명령 Preferences: Configure Language Specific Settings(명령 ID: workbench.action.configureLanguageBasedSettings
)을 실행하는 것입니다. 이렇게 하면 언어 선택기가 열립니다. 원하는 언어를 선택하세요. 그러면 선택한 언어에 대한 언어 필터가 있는 설정 에디터가 열려 해당 언어에 대한 언어별 설정을 수정할 수 있습니다. 단, workbench.settings.editor
를 json
으로 설정한 경우에는 적용 가능한 설정을 추가할 수 있는 새로운 언어 항목이 있는 settings.json
파일이 열립니다.