사용자 및 작업 영역 설정

다양한 설정을 통해 Visual Studio Code를 원하는 대로 구성할 수 있습니다. VS Code 편집기, 사용자 인터페이스 및 기능 동작의 거의 모든 부분에 수정 가능한 옵션이 있습니다.

VS Code는 설정을 위한 다양한 범위를 제공합니다.

• 사용자 설정 - 열려 있는 모든 VS Code 인스턴스에 전역적으로 적용되는 설정입니다.
• 작업 영역 설정 - 작업 영역 내에 저장되며 작업 영역을 열 때만 적용되는 설정입니다.

VS Code는 설정 값을 설정 JSON 파일에 저장합니다. 설정 JSON 파일을 편집하거나 설정을 관리하기 위한 그래픽 인터페이스를 제공하는 설정 편집기를 사용하여 설정 값을 변경할 수 있습니다.

사용자 설정

사용자 설정은 VS Code를 사용자 지정하기 위한 개인 설정입니다. 이 설정은 열려 있는 모든 VS Code 인스턴스에 전역적으로 적용됩니다. 예를 들어, 사용자 설정에서 편집기 글꼴 크기를 14로 설정하면 컴퓨터의 모든 VS Code 인스턴스에서 14가 됩니다.

사용자 설정에 액세스하는 몇 가지 방법이 있습니다.

• 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 사용자 설정 열기 명령을 선택합니다.
• 설정 편집기의 사용자 탭을 선택합니다 (⌘, (Windows, Linux Ctrl+,)).
• 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 사용자 설정(JSON) 열기 명령을 선택합니다.

작업 영역 설정

작업 영역 설정은 프로젝트별이며 사용자 설정을 재정의합니다. 특정 프로젝트에 적용하려는 특정 설정이 있는 경우 작업 영역 설정을 사용할 수 있습니다. 예를 들어, 백엔드 서버 프로젝트의 경우 파일 탐색기에서 node_modules 폴더를 제외하도록 files.exclude 설정을 설정할 수 있습니다.

VS Code는 프로젝트 루트의 .vscode 폴더에 작업 영역 설정을 저장합니다. 이렇게 하면 버전 제어(예: Git) 프로젝트에서 다른 사람들과 설정을 쉽게 공유할 수 있습니다.

작업 영역 설정에 액세스하는 몇 가지 방법이 있습니다.

• 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 작업 영역 설정 열기 명령을 선택합니다.
• 설정 편집기의 작업 영역 탭을 선택합니다 (⌘, (Windows, Linux Ctrl+,)).
• 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 작업 영역 설정(JSON) 열기 명령을 선택합니다.

모든 사용자 설정이 작업 영역 설정으로 제공되는 것은 아닙니다. 예를 들어, 업데이트 및 보안과 관련된 애플리케이션 전체 설정은 작업 영역 설정으로 재정의할 수 없습니다.

설정 편집기

설정 편집기는 사용자 및 작업 영역 설정을 모두 관리하기 위한 그래픽 인터페이스를 제공합니다. 설정 편집기를 열려면 파일 > 환경 설정 > 설정으로 이동합니다. 또는 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 설정 열기를 사용하여 설정 편집기를 열거나 키보드 단축키(⌘, (Windows, Linux Ctrl+,))를 사용합니다.

설정 편집기를 열면 원하는 설정을 검색하고 찾을 수 있습니다. 검색창을 사용하여 검색하면 설정 편집기는 검색 기준과 일치하는 설정만 표시하도록 필터링합니다. 이렇게 하면 설정을 빠르고 쉽게 찾을 수 있습니다.

VS Code는 설정을 변경하는 즉시 변경 사항을 적용합니다. 편집기에서 수정된 줄과 유사하게 설정 왼쪽의 색상 표시줄로 수정된 설정을 식별할 수 있습니다.

아래 예시에서는 사이드바 위치와 파일 아이콘 테마가 변경되었습니다.

설정 옆의 톱니바퀴 아이콘(⇧F9 (Windows, Linux Shift+F9))을 클릭하면 해당 설정을 기본값으로 재설정하고, 설정 ID를 복사하거나, JSON 이름-값 쌍을 복사하거나, 설정 URL을 복사하는 옵션이 있는 컨텍스트 메뉴가 열립니다.

설정 그룹

설정은 그룹으로 표시되어 관련 설정을 빠르게 탐색할 수 있습니다. 상단에는 인기 있는 사용자 지정 설정을 보여주는 **자주 사용되는** 그룹이 있습니다.

다음 예시에서는 트리 보기에서 소스 제어를 선택하여 소스 제어 설정을 집중적으로 표시합니다.

설정 편집기 필터

설정 편집기 검색창에는 설정을 더 쉽게 관리할 수 있도록 여러 필터가 있습니다. 검색창 오른쪽에 깔때기 아이콘이 있는 필터 버튼이 있으며, 이를 클릭하면 검색창에 쉽게 필터를 추가할 수 있습니다.

수정된 설정

구성한 설정을 확인하려면 검색창에 @modified 필터가 있습니다. 설정의 값이 기본값과 다르거나 해당 설정 JSON 파일에 명시적으로 설정된 경우 이 필터 아래에 설정이 표시됩니다.

이 필터는 설정을 구성했는지 여부를 잊어버렸거나, 실수로 설정을 구성하여 편집기가 예상대로 작동하지 않는 경우 유용할 수 있습니다.

기타 필터

설정을 검색하는 데 도움이 되는 몇 가지 다른 유용한 필터가 있습니다. 검색창에 @ 기호를 입력하여 다른 필터를 찾아보세요.

사용 가능한 필터 중 일부입니다.

• @ext: 확장 프로그램별 설정입니다. @ext:ms-python.python과 같은 확장 프로그램 ID를 제공합니다.
• @feature: **기능** 하위 그룹별 설정입니다. 예를 들어 @feature:explorer는 파일 탐색기의 설정을 표시합니다.
• @haspolicy: 조직에서 제어하는 설정입니다.
• @id: 설정 ID를 기준으로 설정을 찾습니다. 예를 들어 @id:workbench.activityBar.visible입니다.
• @lang: 언어 ID를 기준으로 언어 필터를 적용합니다. 예를 들어 @lang:typescript입니다. 자세한 내용은 언어별 편집기 설정을 참조하세요.
• @tag: VS Code 시스템별 설정입니다. 예를 들어, 작업 영역 신뢰 관련 설정의 경우 @tag:workspaceTrust, 접근성 관련 설정의 경우 @tag:accessibility, 고급 VS Code 설정의 경우 @tag:advanced입니다.

검색창은 설정 검색 쿼리를 기억하고 실행 취소 또는 다시 실행(⌘Z (Windows, Linux Ctrl+Z))/⇧⌘Z (Windows, Linux Ctrl+Y))을 지원합니다. 검색창 오른쪽의 설정 검색 입력 지우기 버튼을 사용하여 검색어 또는 필터를 빠르게 지울 수 있습니다.

확장 설정

설치된 VS Code 확장은 자체 설정을 추가할 수도 있으며, 이 설정은 설정 편집기의 확장 섹션에서 검토할 수 있습니다.

확장 보기(⇧⌘X (Windows, Linux Ctrl+Shift+X))에서 확장을 선택하고 **기능 기여** 탭을 검토하여 확장 프로그램의 설정을 검토할 수도 있습니다.

확장 프로그램 작성자는 사용자 지정 설정을 추가하는 방법에 대해 구성 기여 지점 문서에서 자세히 알아볼 수 있습니다.

설정 JSON 파일

VS Code는 설정 값을 settings.json 파일에 저장합니다. 설정 편집기는 settings.json 파일에 저장된 설정 값을 검토하고 수정할 수 있게 해주는 사용자 인터페이스입니다.

명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 사용자 설정(JSON) 열기 또는 환경 설정: 작업 영역 설정(JSON) 열기 명령을 사용하여 편집기에서 settings.json 파일을 열어 직접 검토하고 편집할 수도 있습니다.

설정은 설정 ID와 값을 지정하여 JSON으로 작성됩니다. 설정 편집기에서 설정의 톱니바퀴 아이콘을 선택한 다음 설정을 JSON으로 복사 작업을 선택하여 해당 JSON 이름-값 쌍을 빠르게 복사할 수 있습니다.

settings.json 파일은 설정 및 값에 대한 스마트 완성 기능과 설명 호버 기능을 갖춘 완전한 IntelliSense를 제공합니다. 잘못된 설정 이름 또는 JSON 형식으로 인한 오류도 강조 표시됩니다.

작업 영역: 색상 사용자 지정과 같이 settings.json에서만 편집할 수 있는 설정이 있으며, 설정 편집기에는 settings.json에서 편집 링크가 표시됩니다.

설정 파일 위치

사용자 설정.json 위치

플랫폼에 따라 사용자 설정 파일은 여기에 있습니다.

• Windows %APPDATA%\Code\User\settings.json
• macOS $HOME/Library/Application\ Support/Code/User/settings.json
• Linux $HOME/.config/Code/User/settings.json

작업 영역 설정.json 위치

작업 영역 설정 파일은 루트 폴더의 .vscode 폴더 아래에 있습니다. 프로젝트 또는 소스 제어에 작업 영역 설정 settings.json 파일을 추가하면 해당 프로젝트의 모든 사용자가 프로젝트에 대한 설정을 공유하게 됩니다.

설정 재설정

설정 위로 마우스를 가져가 톱니바퀴 아이콘을 표시하고, 톱니바퀴 아이콘을 클릭한 다음 설정 재설정 작업을 선택하여 설정을 기본값으로 항상 재설정할 수 있습니다.

설정 편집기를 통해 개별 설정을 재설정할 수 있지만, settings.json을 열고 중괄호 {} 사이의 항목을 삭제하여 변경된 모든 설정을 재설정할 수 있습니다. 이전 설정 값을 복구할 방법이 없으므로 주의하십시오.

언어별 편집기 설정

언어별 설정을 사용자 지정하는 한 가지 방법은 설정 편집기를 열고 필터 버튼을 누른 다음 언어 옵션을 선택하여 언어 필터를 추가하는 것입니다. 또는 @lang:languageId 형식의 언어 필터를 검색 위젯에 직접 입력할 수도 있습니다. 표시되는 설정은 해당 특정 언어에 대해 구성 가능하며, 해당되는 경우 해당 언어에 대한 설정 값을 표시합니다.

언어 필터가 적용된 상태에서 설정을 수정하면 해당 언어의 해당 범위에 대해 설정이 구성됩니다. 예를 들어, @lang:css 필터가 검색 위젯에 있는 동안 사용자 범위의 diffEditor.codeLens 설정을 수정하면, 설정 편집기는 사용자 설정 파일의 CSS별 섹션에 새 값을 저장합니다.

언어별로 편집기를 사용자 지정하는 또 다른 방법은 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 전역 명령 환경 설정: 언어별 설정 구성(명령 ID: workbench.action.configureLanguageBasedSettings)을 실행하는 것입니다. 그러면 언어 선택기가 열립니다. 원하는 언어를 선택합니다. 그러면 해당 언어에 대한 언어별 설정을 수정할 수 있도록 해당 언어에 대한 필터가 있는 설정 편집기가 열립니다. 그러나 workbench.settings.editor 설정이 json으로 설정되어 있으면 settings.json 파일이 새 언어 항목과 함께 열리고 해당 설정을 추가할 수 있습니다.

드롭다운에서 언어 선택

이제 해당 언어에 대한 설정을 구체적으로 편집할 수 있습니다.

또는 workbench.settings.editor가 json으로 설정된 경우, 이제 사용자 설정에 언어별 설정을 추가할 수 있습니다.

파일이 열려 있고 이 파일 형식에 대한 편집기를 사용자 지정하려는 경우, VS Code 창의 오른쪽 하단에 있는 상태 표시줄에서 언어 모드를 선택합니다. 그러면 언어 선택기가 열리고 'language_name' 언어별 설정 구성 옵션이 표시됩니다. 이를 선택하면 해당 설정을 추가할 수 있는 언어 항목이 포함된 사용자 settings.json 파일이 열립니다.

언어별 편집기 설정은 비언어별 편집기 설정을 항상 재정의하며, 비언어별 설정의 범위가 더 좁더라도 마찬가지입니다. 예를 들어, 언어별 사용자 설정은 비언어별 작업 영역 설정을 재정의합니다.

사용자 설정과 마찬가지로 작업 영역 설정에 배치하여 언어별 설정을 작업 영역 범위로 지정할 수 있습니다. 사용자 및 작업 영역 범위 모두에 대해 동일한 언어에 대한 설정이 정의된 경우, 작업 영역에 정의된 설정에 우선순위를 부여하여 병합됩니다.

다음 예시를 설정 JSON 파일에 붙여넣어 typescript 및 markdown 언어 모드에 대한 편집기 설정을 사용자 지정할 수 있습니다.

{
  "[typescript]": {
    "editor.formatOnSave": true,
    "editor.formatOnPaste": true
  },
  "[markdown]": {
    "editor.formatOnSave": true,
    "editor.wordWrap": "on",
    "editor.renderWhitespace": "all",
    "editor.acceptSuggestionOnEnter": "off"
  }
}

settings.json에서 IntelliSense를 사용하여 언어별 설정을 찾을 수 있습니다. 모든 편집기 설정 및 일부 비편집기 설정이 지원됩니다. 일부 언어에는 이미 기본 언어별 설정이 설정되어 있으며, 환경 설정: 기본 설정 열기 명령을 실행하여 defaultSettings.json에서 이를 검토할 수 있습니다.

여러 언어별 편집기 설정

여러 언어에 대해 언어별 편집기 설정을 한 번에 구성할 수 있습니다. 다음 예시에서는 settings.json 파일에서 javascript 및 typescript 언어에 대한 설정을 함께 사용자 지정하는 방법을 보여줍니다.

"[javascript][typescript]": {
  "editor.maxTokenizationLineLength": 2500
}

프로필 설정

VS Code의 프로필을 사용하여 사용자 지정 세트를 만들고 빠르게 전환할 수 있습니다. 예를 들어, 특정 프로그래밍 언어에 대한 VS Code를 사용자 지정하는 데 유용합니다.

프로필로 전환하면 사용자 설정은 해당 프로필로만 범위가 지정됩니다. 다른 프로필로 전환하면 해당 다른 프로필의 사용자 설정이 적용됩니다. 이렇게 하면 프로필마다 다른 설정을 가질 수 있습니다.

프로필의 사용자 설정 JSON 파일은 다음 디렉토리에 있습니다.

• Windows %APPDATA%\Code\User\profiles\<profile ID>\settings.json
• macOS $HOME/Library/Application\ Support/Code/User/profiles/<profile ID>/settings.json
• Linux $HOME/.config/Code/User/profiles/<profile ID>/settings.json

<profile ID>는 프로필의 고유 식별자입니다. 설정을 재정의하는 각 프로필에 대해 해당 프로필 설정 파일이 있습니다.

기본이 아닌 프로필을 사용하는 경우, 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 응용 프로그램 설정(JSON) 열기 명령을 사용하여 기본 프로필과 연결된 settings.json 파일에 액세스할 수 있습니다.

설정 우선순위

구성은 다른 설정 범위에 의해 여러 수준에서 재정의될 수 있습니다. 다음 목록에서 **나중 범위가 이전 범위를 재정의합니다.**

• 기본 설정 - 이 범위는 구성되지 않은 기본 설정 값을 나타냅니다.
• 사용자 설정 - 모든 VS Code 인스턴스에 전역적으로 적용됩니다.
• 원격 설정 - 사용자가 연 원격 컴퓨터에 적용됩니다.
• 작업 영역 설정 - 열려 있는 폴더 또는 작업 영역에 적용됩니다.
• 작업 영역 폴더 설정 - 다중 루트 작업 영역의 특정 폴더에 적용됩니다.
• 언어별 기본 설정 - 확장 프로그램에서 제공할 수 있는 언어별 기본값입니다.
• 언어별 사용자 설정 - 사용자 설정과 동일하지만 언어별입니다.
• 언어별 원격 설정 - 원격 설정과 동일하지만 언어별입니다.
• 언어별 작업 영역 설정 - 작업 영역 설정과 동일하지만 언어별입니다.
• 언어별 작업 영역 폴더 설정 - 작업 영역 폴더 설정과 동일하지만 언어별입니다.
• 정책 설정 - 시스템 관리자가 설정하며, 이 값은 항상 다른 설정 값을 재정의합니다.

설정 값은 다양한 유형이 될 수 있습니다.

• 문자열 - "files.autoSave": "afterDelay"
• 부울 - "editor.minimap.enabled": true
• 숫자 - "files.autoSaveDelay": 1000
• 배열 - "editor.rulers": []
• 객체 - "search.exclude": { "**/node_modules": true, "**/bower_components": true }

기본 유형 및 배열 유형의 값은 재정의됩니다. 즉, 다른 범위보다 우선순위가 높은 범위에 구성된 값이 다른 범위의 값 대신 사용됩니다. 그러나 객체 유형의 값은 병합됩니다.

예를 들어, workbench.colorCustomizations는 UI 요소 그룹과 원하는 색상을 지정하는 객체를 사용합니다. 사용자 설정에서 편집기 배경을 파란색과 녹색으로 설정하면

  "workbench.colorCustomizations": {
    "editor.background": "#000088",
    "editor.selectionBackground": "#008800"
  }

열려 있는 작업 영역 설정에서 편집기 전경을 빨간색으로 설정하면

  "workbench.colorCustomizations": {
    "editor.foreground": "#880000",
    "editor.selectionBackground": "#00FF00"
  }

해당 작업 영역이 열릴 때 결과는 다음과 같이 지정된 것처럼 두 가지 색상 사용자 지정의 조합입니다.

  "workbench.colorCustomizations": {
    "editor.background": "#000088",
    "editor.selectionBackground": "#00FF00",
    "editor.foreground": "#880000"
  }

충돌하는 값이 있는 경우(예: 위의 예시에서 editor.selectionBackground), 일반적인 재정의 동작이 발생하며, 작업 영역 값이 사용자 값보다 우선하고, 언어별 값이 비언어별 값보다 우선합니다.

여러 언어별 설정에 대한 참고 사항

여러 언어별 설정을 사용하는 경우, 언어별 설정은 병합되고 우선순위는 개별 언어 ID(typescript 및 javascript)가 아닌 전체 언어 문자열(예: "[typescript][javascript]")을 기준으로 설정된다는 점에 유의하십시오. 즉, 예를 들어 "[typescript][javascript]" 작업 영역 설정은 "[javascript]" 사용자 설정을 재정의하지 않습니다.

설정 및 보안

일부 설정은 VS Code가 특정 작업을 수행하기 위해 실행할 실행 파일을 지정할 수 있도록 합니다. 예를 들어, 통합 터미널이 사용해야 하는 셸을 선택할 수 있습니다. 보안 강화를 위해 이러한 설정은 작업 영역 범위가 아닌 사용자 설정에만 정의할 수 있습니다.

작업 영역 설정에서 지원되지 않는 설정 목록입니다.

• git.path
• terminal.external.windowsExec
• terminal.external.osxExec
• terminal.external.linuxExec

이러한 설정 중 하나를 정의하는 작업 영역을 처음 열 때 VS Code는 경고를 표시한 다음 이후에는 해당 값을 항상 무시합니다.

설정 동기화

설정 동기화 기능을 사용하여 VS Code 인스턴스 간에 사용자 설정을 공유할 수 있습니다. 이 기능을 사용하면 여러 컴퓨터에 설치된 VS Code 설치 전반에 걸쳐 설정, 키보드 바로 가기 및 설치된 확장을 공유할 수 있습니다. 설정 동기화는 설정 편집기 오른쪽의 설정 백업 및 동기화 명령 또는 **계정** 활동 표시줄 컨텍스트 메뉴를 통해 활성화할 수 있습니다.

설정 동기화 설정 및 구성에 대한 자세한 내용은 설정 동기화 사용자 가이드를 참조하세요.

기능 수명 주기

기능 및 해당 설정은 다음 상태 중 하나에 있을 수 있습니다. 상태에 따라 워크플로에서 해당 기능 또는 설정을 사용하는 것에 주의해야 할 수 있습니다.

• 실험적 - 얼리 어답터에게 제공되는 탐색 기능입니다. 이러한 기능은 향후 변경되거나 제거될 수 있습니다. 설정 편집기에서 이러한 설정에는 실험적 레이블이 붙어 있습니다. 검색 상자에 @tag:experimental을 입력하여 실험적 설정을 검색할 수도 있습니다.

  

• 미리 보기 - 미리 보기 기능 및 설정에는 최종 기능이 있지만 안정성 및 다듬기를 위해 반복될 수 있습니다. 일반적으로 미리 보기 기능은 기본적으로 비활성화되어 있습니다. 설정 편집기에서 이러한 설정에는 미리 보기 레이블이 붙어 있습니다. 검색 상자에 @tag:preview를 입력하여 미리 보기 설정을 검색할 수도 있습니다.

  

• 안정적 - 기능이 안정적이며 VS Code에서 완전히 지원됩니다.

실험적 및 미리 보기 기능은 새로운 기능을 사용해 보고 피드백을 제공할 수 있도록 합니다. VS Code 이슈에 피드백을 공유하세요.

관련 리소스

• VS Code 기본 설정 참조
• 여러 컴퓨터에서 설정 동기화

자주 묻는 질문

VS Code에서 "설정을 쓸 수 없습니다."라고 표시됨

설정을 변경하려고 할 때(예: 자동 저장 켜기 또는 새 색 테마 선택) "사용자 설정에 쓸 수 없습니다. 잘못된 오류/경고를 수정하기 위해 사용자 설정을 열고 다시 시도하십시오."라는 메시지가 표시되면 settings.json 파일의 형식이 잘못되었거나 오류가 있다는 의미입니다. 오류는 누락된 쉼표 또는 잘못된 설정 값과 같이 간단할 수 있습니다. 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 사용자 설정(JSON) 열기 명령을 사용하여 settings.json 파일을 열면 오류가 빨간색 물결선으로 강조 표시된 것을 볼 수 있습니다.

사용자 설정을 재설정하는 방법은 무엇인가요?

VS Code를 기본 설정으로 재설정하는 가장 쉬운 방법은 사용자 settings.json 파일을 지우는 것입니다. 명령 팔레트(⇧⌘P (Windows, Linux Ctrl+Shift+P))에서 환경 설정: 사용자 설정(JSON) 열기 명령을 사용하여 settings.json 파일을 열 수 있습니다. 파일이 편집기에서 열리면 두 개의 중괄호 {} 사이의 모든 내용을 삭제하고 파일을 저장하면 VS Code가 기본값을 사용하게 됩니다.

작업 영역 설정을 사용하는 것이 좋은 경우는 언제인가요?

사용자 지정 설정이 필요한 작업 영역을 사용하지만 다른 VS Code 프로젝트에 적용하고 싶지 않을 때입니다. 언어별 린팅 규칙이 좋은 예입니다.

확장 설정은 어디에서 찾을 수 있나요?

일반적으로 VS Code 확장은 사용자 또는 작업 영역 설정 파일에 설정을 저장하며, 설정 편집기 UI(환경 설정: 설정(UI) 열기 명령) 또는 settings.json 파일의 IntelliSense(환경 설정: 사용자 설정(JSON) 열기 명령)를 통해 액세스할 수 있습니다. 확장 프로그램 이름(예: gitlens 또는 python)으로 검색하면 해당 확장 프로그램에서 제공하는 설정만 필터링하는 데 도움이 될 수 있습니다.