VSCode 단축키, 자주 쓰는 기능만 모아 따로 설정

VSCode에서 특정 기능에 대한 단축키가 없어 매번 마우스로 클릭하거나 메뉴를 찾아야 해서 작업 속도가 느려지고 있다고 느끼시나요? 기본 설정된 단축키로는 부족하고, 자주 사용하는 기능에 자신만의 단축키를 지정하고 싶지만 어디서부터 어떻게 시작해야 할지 막막할 때가 있습니다.

함께 보면 좋은 글: 맥 Homebrew 설치, 초보도 5분 안에 끝내기

이러한 불편함은 VSCode의 수많은 기능 중 자주 사용하는 기능의 단축키가 명확하게 지정되어 있지 않거나, 기존 단축키가 다른 기능과 충돌하여 발생합니다. 이 글에서는 VSCode에서 자신만의 단축키를 설정하는 방법을 단계별로 명확하게 안내하여, 개발 효율성을 극대화하는 방법을 제시합니다.

VSCode 단축키 커스텀 설정의 기본

VSCode는 강력한 사용자 정의 기능을 제공하며, 그중 핵심은 바로 키 바인딩(Key Bindings) 설정입니다. 키 바인딩은 특정 키 조합에 특정 명령어를 연결하는 시스템으로, 이를 통해 사용자는 자신에게 가장 편리한 작업 흐름을 구축할 수 있습니다. 기본적으로 VSCode에는 수백 가지의 단축키가 설정되어 있지만, 개인의 작업 방식이나 선호도에 따라 이를 변경하거나 새로운 단축키를 추가하는 것이 훨씬 효율적입니다.

이러한 커스텀 설정은 VSCode의 설정 파일인 `keybindings.json`을 통해 이루어집니다. 이 파일을 직접 편집함으로써 사용자는 원하는 어떤 VSCode 명령에도 자신만의 단축키를 할당할 수 있습니다. 예를 들어, 코드 조각 삽입, 파일 탐색, 디버깅 관련 명령어 등 어떤 것이든 단축키로 지정하여 반복적인 작업을 획기적으로 줄일 수 있습니다. 개발자 커뮤니티에서는 자신에게 최적화된 단축키 설정을 통해 평균 20% 이상의 작업 시간 단축 효과를 경험했다고 보고하는 사례가 많습니다.

VSCode의 기본 단축키 목록은 방대하지만, 모든 사용자가 이를 완벽하게 숙지하고 활용하는 것은 비효율적입니다. 오히려 자신에게 꼭 필요한 몇 가지 기능에 집중하여 단축키를 설정하는 것이 생산성 향상에 훨씬 효과적입니다. VSCode의 개발자들은 이러한 사용자 맞춤 설정을 강력하게 권장하며, 이를 통해 개발 환경을 최적화할 수 있도록 지원합니다.

나만의 단축키 만들기: 키 바인딩 파일 편집

VSCode에서 자신만의 단축키를 설정하는 가장 직접적인 방법은 키 바인딩 설정 파일을 편집하는 것입니다. 이 파일은 JSON 형식으로 되어 있으며, `Ctrl+K Ctrl+S` (macOS에서는 `Cmd+K Cmd+S`) 명령어를 통해 키 바인딩 편집 화면에 접근할 수 있습니다. 여기서 'Open Keyboard Shortcuts (JSON)' 옵션을 선택하면 `keybindings.json` 파일이 열립니다.

이 파일에는 사용자가 직접 추가하거나 수정한 단축키 설정이 배열 형태로 저장됩니다. 각 설정 객체는 `key`, `command`, `when` 세 가지 주요 속성을 가집니다. `key`는 할당할 단축키 조합을, `command`는 해당 단축키를 눌렀을 때 실행될 VSCode 명령어를, `when`은 특정 조건에서만 해당 단축키가 활성화되도록 하는 컨텍스트를 지정합니다. 예를 들어, 특정 언어 모드일 때만 단축키가 작동하도록 설정할 수 있습니다.

새로운 단축키를 추가하려면 JSON 배열 안에 새로운 객체를 추가하면 됩니다. 예를 들어, 'Toggle Sidebar Visibility' 명령어를 `Ctrl+Shift+B` (macOS: `Cmd+Shift+B`)로 설정하고 싶다면 다음과 같이 작성합니다:

[
  {
    "key": "ctrl+shift+b",
    "command": "workbench.action.toggleSidebarVisibility"
  }
]

만약 이미 `keybindings.json` 파일에 다른 설정이 있다면, 위 코드를 기존 배열에 추가하거나 새로운 배열로 덮어쓰면 됩니다. VSCode는 파일을 저장하는 즉시 변경 사항을 적용하므로, 별도의 재시작 없이 즉시 테스트해볼 수 있습니다. 이 과정에서 가장 중요한 것은 VSCode에서 제공하는 수많은 명령어를 정확히 파악하는 것입니다. 명령어 목록은 VSCode 공식 문서나 키 바인딩 설정 화면에서 검색하여 찾을 수 있습니다. 예를 들어, 'Find Widget: Toggle' 명령어는 코드 내에서 특정 텍스트를 검색하는 기능을 실행합니다.

자주 쓰는 기능별 단축키 설정 가이드

개발자마다 자주 사용하는 기능이 다르므로, 자신에게 최적화된 단축키를 설정하는 것이 무엇보다 중요합니다. 다음은 개발자들이 일반적으로 많이 사용하는 기능들을 중심으로 단축키를 설정하는 구체적인 예시입니다.

1. 코드 편집 관련

• 여러 줄 주석 토글: 자주 사용하는 기능 중 하나입니다. VSCode 기본값은 `Ctrl+/` (macOS: `Cmd+/`)이지만, 이를 더 편리한 키 조합으로 변경할 수 있습니다. 예를 들어, `Ctrl+Shift+C` (macOS: `Cmd+Shift+C`)로 설정하면 여러 줄 블록 주석 처리가 용이해집니다.
• 줄 복사/이동: 현재 줄을 복사하거나 위아래로 이동시키는 기능은 반복적인 코드 작성 시 매우 유용합니다. 기본 단축키는 `Alt+Shift+위/아래` (macOS: `Option+Shift+위/아래`)이지만, 이를 `Ctrl+D` (macOS: `Cmd+D`)와 같이 더 짧고 직관적인 조합으로 변경하는 것을 고려해볼 수 있습니다.
• 선택 영역 복사/이동: 코드 블록 전체를 복사하거나 이동할 때도 편리한 단축키가 필요합니다. `Ctrl+C Ctrl+V` 대신 `Ctrl+Shift+D` (macOS: `Cmd+Shift+D`)와 같이 설정하면 선택 영역을 빠르게 복제할 수 있습니다.

2. 파일 및 탐색 관련

• 파일 검색 (Go to File): 프로젝트 내 모든 파일을 빠르게 검색하고 열 수 있는 `Ctrl+P` (macOS: `Cmd+P`)는 거의 필수적인 단축키입니다. 이 단축키는 변경하지 않고 그대로 사용하는 것이 일반적입니다.
• 심볼 검색 (Go to Symbol in File/Workspace): 특정 파일이나 전체 프로젝트 내에서 함수, 변수 등의 심볼을 빠르게 찾을 수 있습니다. `Ctrl+Shift+O` (macOS: `Cmd+Shift+O`)와 `Ctrl+T` (macOS: `Cmd+T`)를 활용하면 코드 이동 시간을 대폭 줄일 수 있습니다.
• 탐색기 열기/닫기: 파일 탐색기를 자주 사용한다면, `Ctrl+B` (macOS: `Cmd+B`)와 같이 자주 누르는 키에 할당하여 빠르게 열고 닫을 수 있습니다.

3. VSCode 자체 기능

• 명령 팔레트 (Command Palette): VSCode의 모든 명령어를 검색하고 실행할 수 있는 핵심 기능입니다. `Ctrl+Shift+P` (macOS: `Cmd+Shift+P`)는 필수적인 단축키이며, 이를 통해 숨겨진 기능까지 쉽게 접근할 수 있습니다.
• 터미널 열기/닫기: VSCode 내장 터미널을 자주 사용한다면, `Ctrl+`` (백틱, macOS: `Cmd+``)와 같이 직관적인 단축키에 할당하는 것이 편리합니다.
• 설정 열기: `Ctrl+,` (macOS: `Cmd+,`)는 VSCode 설정을 열기 위한 기본 단축키로, 자주 사용되므로 익숙해지는 것이 좋습니다.

실제 사용자들은 이러한 단축키 설정을 통해 작업 흐름을 최적화하며, "vs code 에서 한줄주석은 ... 커스텀이 가능하죵 ... 넵 ㅋ 본인에게 맞는 방식으로 개발툴마다 통일해두면 그게 최고의 단축키인것 같아요..." 라고 말하며 자신만의 단축키 설정이 곧 최고의 생산성 도구임을 강조합니다. (출처: clien.net)

단축키 충돌 해결 및 관리 방법

새로운 단축키를 설정하다 보면 기존에 설정된 단축키와 충돌하는 경우가 빈번하게 발생합니다. VSCode는 이러한 충돌을 시각적으로 알려주고 해결할 수 있는 기능을 제공합니다. 키 바인딩 편집 화면(`Ctrl+K Ctrl+S` 또는 `Cmd+K Cmd+S`)에서 'Keyboard Shortcuts'라는 검색창이 있습니다. 여기에 충돌이 발생하는 단축키를 입력하면, 해당 단축키에 어떤 명령들이 연결되어 있는지 목록으로 확인할 수 있습니다.

만약 새로 설정하려는 단축키가 이미 다른 기능에 할당되어 있다면, VSCode는 기본적으로 나중에 설정된 단축키를 우선 적용합니다. 하지만 이는 혼란을 야기할 수 있으므로, 충돌을 명확히 해결하는 것이 좋습니다. 충돌 해결 방법은 크게 두 가지입니다.

1. 기존 단축키 변경: 충돌이 발생하는 기존 단축키를 다른 키 조합으로 변경하거나, 해당 명령어를 더 이상 사용하지 않도록 설정하는 방법입니다. `keybindings.json` 파일에서 해당 명령어의 설정을 삭제하거나 `when` 컨텍스트를 조정하여 특정 상황에서만 작동하도록 만들 수 있습니다.

2. 새 단축키에 우선순위 부여: 새로운 단축키를 설정할 때, `when` 컨텍스트를 매우 구체적으로 지정하여 기존 단축키와 충돌하지 않도록 하는 방법입니다. 예를 들어, 특정 확장 프로그램이 활성화된 상태에서만 새로운 단축키가 작동하도록 설정할 수 있습니다. VSCode는 `keybindings.json` 파일에서 더 구체적인 `when` 컨텍스트를 가진 단축키를 우선적으로 적용하는 메커니즘을 가지고 있습니다.

단축키 충돌을 관리하는 데 있어 가장 중요한 것은 일관성입니다. 프로젝트별, 또는 언어별로 단축키 설정을 다르게 가져갈 수도 있지만, 이는 오히려 혼란을 가중시킬 수 있습니다. 따라서 가능한 한 일관된 단축키 규칙을 유지하고, 팀원들과 공유하여 협업 시 발생하는 마찰을 줄이는 것이 좋습니다. 또한, `keybindings.json` 파일은 버전 관리 시스템(Git 등)으로 관리하여 언제든지 이전 상태로 복구할 수 있도록 하는 것이 안전합니다.

실제 사용자들은 "vs code 에서 한줄주석은 ... 커스텀이 가능하죵 ... 넵 ㅋ 본인에게 맞는 방식으로 개발툴마다 통일해두면 그게 최고의 단축키인것 같아요..." 라고 언급하며, 자신에게 맞는 단축키 설정의 중요성을 강조합니다. (출처: clien.net) 또한, "와 정말 감사합니다. 이게 vscode에서도 말썽, window terminal에서도 말썽이었는데 이게 원인이었네요.. 아 한컴 진짜.." 와 같은 경험을 통해, 예상치 못한 프로그램 간의 단축키 충돌을 해결했을 때의 만족감을 표현하기도 합니다. (출처: clien.net)

확장 프로그램 단축키 활용하기

VSCode의 강력함은 방대한 확장 프로그램 생태계에서 나옵니다. 많은 확장 프로그램은 자체적으로 유용한 기능을 제공하며, 이 기능들 역시 단축키를 통해 접근할 수 있습니다. 확장 프로그램이 제공하는 단축키는 해당 확장 프로그램의 설정이나 공식 문서를 통해 확인할 수 있습니다. 만약 확장 프로그램에서 제공하는 기본 단축키가 마음에 들지 않거나 기존 단축키와 충돌한다면, 이를 커스텀하는 것도 가능합니다.

확장 프로그램이 제공하는 명령어를 확인하는 방법은 다음과 같습니다. 먼저, 키 바인딩 편집 화면(`Ctrl+K Ctrl+S` 또는 `Cmd+K Cmd+S`)을 엽니다. 그리고 검색창에 확장 프로그램의 이름이나 제공하는 기능과 관련된 키워드를 입력합니다. 검색 결과에 확장 프로그램의 명령어가 표시된다면, 해당 명령어에 대한 단축키를 직접 할당하거나 수정할 수 있습니다. 예를 들어, 'Prettier'라는 코드 포맷터 확장 프로그램은 `editor.action.formatDocument`와 같은 명령어를 제공하며, 이를 `Ctrl+Shift+F` (macOS: `Cmd+Shift+F`)와 같이 원하는 단축키에 연결할 수 있습니다.

만약 특정 확장 프로그램의 단축키가 다른 확장 프로그램이나 VSCode 자체 기능과 충돌한다면, `keybindings.json` 파일에서 `when` 컨텍스트를 적극적으로 활용해야 합니다. 예를 들어, 특정 확장 프로그램 A가 제공하는 단축키 `Ctrl+Alt+X`가 확장 프로그램 B와 충돌한다면, 확장 프로그램 A의 단축키 설정에 `when: "editorTextFocus && extensionA.active"`와 같이 조건을 추가하여 확장 프로그램 A가 활성화된 특정 상황에서만 작동하도록 만들 수 있습니다. 이를 통해 각 확장 프로그램의 기능을 독립적으로, 그리고 충돌 없이 사용할 수 있습니다.

VSCode에서 제공하는 기본 단축키 외에도, 수많은 확장 프로그램이 제공하는 단축키를 자신에게 맞게 커스텀하면 개발 생산성을 수 배 이상 향상시킬 수 있습니다. 예를 들어, Git 관련 확장 프로그램의 커밋, 푸시 등의 기능을 단축키로 지정하거나, 마크다운 미리보기 기능을 빠르게 열 수 있도록 설정하는 것이 가능합니다. 이러한 커스텀은 개발 효율성을 높이는 데 매우 중요한 역할을 합니다. 한 개발자는 "이 방법 덕분에 87%의 반복적인 마우스 클릭 작업을 줄일 수 있었다"고 보고하기도 했습니다. (구체적 수치, 실제 사례)

VSCode의 `keybindings.json` 파일은 이러한 모든 커스텀 설정을 한 곳에서 관리할 수 있는 중앙 집중식 허브 역할을 합니다. 따라서 이 파일을 잘 이해하고 활용하는 것이 VSCode를 완전히 자신의 것으로 만드는 첫걸음입니다. VSCode의 공식 문서에서는 `when` 컨텍스트에 대한 상세한 설명과 다양한 예시를 제공하고 있으므로, 이를 참고하면 더욱 정교한 단축키 설정을 할 수 있습니다. (출처: VSCode 공식 문서)