VSCode 단축키, 내 손에 딱 맞게 바꾸는 법

반복적인 코딩 작업에 매번 같은 단축키를 누르는 것이 답답하거나, 특정 기능을 더 자주 사용하고 싶을 때 VSCode 단축키 커스텀 설정 방법을 찾고 계신가요? 매번 마우스로 메뉴를 찾아 클릭하는 시간은 쌓이고 쌓여 상당한 업무 효율 저하로 이어집니다. 자신에게 최적화된 개발 환경을 구축하는 것은 생산성 향상의 지름길입니다.

함께 보면 좋은 글: 맥 터미널 답답할 때, iTerm2 & Oh

이러한 불편함은 VSCode가 제공하는 강력한 사용자 정의 기능을 제대로 활용하지 못했기 때문입니다. VSCode는 기본 단축키 외에도 사용자가 원하는 대로 거의 모든 기능을 새롭게 할당하거나 기존 단축키를 변경할 수 있도록 지원합니다. 이 글에서는 VSCode 단축키 커스텀 설정 방법을 상세히 안내하여 여러분의 코딩 경험을 한 단계 업그레이드할 수 있도록 돕겠습니다.

VSCode 단축키 커스텀 설정 방법을 익히면 단순 반복 작업을 줄이고, 자주 사용하는 기능에 빠르게 접근하여 개발 속도를 높일 수 있습니다. 이제부터 여러분의 손에 딱 맞는 맞춤형 VSCode 단축키를 만들어 보세요.

VSCode 단축키 커스텀 설정 방법: 기본 이해

VSCode는 사용자 편의성을 극대화하기 위해 다양한 설정 옵션을 제공하며, 그중에서도 단축키 커스터마이징은 개발자의 생산성에 직접적인 영향을 미치는 핵심 기능입니다. VSCode는 기본적으로 수많은 단축키를 제공하지만, 모든 개발자의 작업 방식과 선호도가 같을 수는 없습니다. 어떤 개발자는 특정 확장 프로그램의 기능을 더 자주 사용할 수 있고, 다른 개발자는 특정 코드 조작 방식을 선호할 수 있습니다.

이러한 개별적인 요구를 충족시키기 위해 VSCode는 사용자가 직접 단축키 설정을 변경할 수 있는 기능을 제공합니다. 이는 단순히 기존 단축키를 바꾸는 것을 넘어, 새로운 단축키를 생성하고, 특정 상황에서만 작동하는 단축키를 정의하는 것까지 가능하게 합니다. VSCode의 단축키 설정은 keybindings.json이라는 JSON 파일을 통해 관리되며, 이 파일을 직접 편집함으로써 원하는 대로 설정을 수정할 수 있습니다. 이 파일은 VSCode의 설정 디렉토리 내에 존재하며, 사용자가 직접 편집하도록 설계되어 있습니다.

VSCode 단축키 커스텀 설정 방법을 제대로 이해하면, 매번 마우스로 메뉴를 찾아 클릭하는 번거로움을 줄이고, 손가락의 움직임을 최소화하여 코딩에 더욱 집중할 수 있습니다. 이는 곧 개발 속도의 향상으로 이어지며, 장기적으로는 개발자의 피로도를 낮추는 데에도 기여합니다. VSCode는 버전 1.0부터 이러한 사용자 정의 기능을 강력하게 지원해 왔으며, 지속적인 업데이트를 통해 더욱 유연하고 강력한 단축키 설정 기능을 제공하고 있습니다.

Photo by Nemuel Sereti on Pexels

나만의 단축키 만들기: JSON 파일 직접 편집

VSCode에서 단축키를 커스터마이징하는 가장 기본적인 방법은 keybindings.json 파일을 직접 편집하는 것입니다. 이 파일은 VSCode의 모든 사용자 정의 단축키 설정을 저장하는 곳으로, JSON 형식으로 구성되어 있습니다. VSCode 내에서 이 파일을 쉽게 열고 편집할 수 있으며, 실시간으로 변경 사항이 적용되어 편리합니다.

먼저, VSCode를 실행한 후 명령 팔레트를 엽니다. Windows/Linux에서는 Ctrl+Shift+P, macOS에서는 Cmd+Shift+P를 눌러 명령 팔레트를 열 수 있습니다. 명령 팔레트에서 “Preferences: Open Keyboard Shortcuts (JSON)”라고 입력하고 해당 명령을 선택하면 keybindings.json 파일이 열립니다.

이 파일은 기본적으로 비어 있거나, 사용자가 추가한 단축키 설정으로 채워집니다. 단축키 설정은 배열 안에 객체 형태로 저장되며, 각 객체는 key, command, when 등의 속성을 가집니다. key는 할당하려는 단축키 조합을, command는 실행하려는 VSCode 명령 ID를, when은 해당 단축키가 활성화될 조건을 나타냅니다. 예를 들어, 파일을 저장하는 기본 단축키 Ctrl+S (Windows/Linux) 또는 Cmd+S (macOS)는 내부적으로 workbench.action.files.save라는 명령 ID를 사용합니다.

새로운 단축키를 추가하려면 다음과 같은 형식으로 JSON 배열에 객체를 추가하면 됩니다. 예를 들어, Alt+T에 "터미널 열기" 기능을 할당하고 싶다면 다음과 같이 작성할 수 있습니다.

[
  {
    "key": "alt+t",
    "command": "workbench.action.terminal.toggleTerminal"
  }
]

VSCode 단축키 커스텀 설정 방법 중 이 JSON 파일 편집은 가장 강력하고 유연한 방식입니다. VSCode의 모든 명령 ID 목록은 개발자 도구 콘솔이나 관련 문서를 통해 확인할 수 있으며, 이를 활용하면 거의 모든 기능을 자신만의 단축키로 제어할 수 있습니다. 실제 사용자는 "vs code 에서 한줄주석은 ... 커스텀이 가능하죵 ... 넵 ㅋ 본인에게 맞는 방식으로 개발툴마다 통일해두면 그게 최고의 단축키인것 같아요..." 와 같이 자신의 작업 환경에 맞춘 단축키 설정의 중요성을 강조하기도 합니다. (출처: clien.net)

자주 사용하는 기능에 단축키 할당하기

개발 과정에서 특정 기능은 다른 기능보다 훨씬 자주 사용될 수 있습니다. 예를 들어, 코드 포맷팅, 파일 탐색기 열기, 특정 언어 서버 기능 활성화 등이 이에 해당합니다. 이러한 자주 사용하는 기능에 자신만의 단축키를 할당하면 작업 흐름이 끊기지 않고 빠르고 효율적으로 코딩할 수 있습니다.

어떤 기능을 단축키로 만들고 싶은지 결정했다면, 다음 단계는 해당 기능의 명령 ID를 찾는 것입니다. VSCode에는 수많은 명령 ID가 내장되어 있으며, 확장 프로그램을 설치하면 해당 확장 프로그램에서 제공하는 명령 ID가 추가됩니다. 명령 ID를 찾는 가장 쉬운 방법 중 하나는 VSCode의 기본 "키보드 바로 가기" 설정 화면을 이용하는 것입니다. 명령 팔레트에서 “Preferences: Open Keyboard Shortcuts”를 검색하여 이 화면을 열 수 있습니다. 여기서 원하는 기능을 검색하면 해당 기능의 명령 ID를 확인할 수 있습니다.

예를 들어, "파일 열기" 기능을 Ctrl+O (Windows/Linux) 또는 Cmd+O (macOS) 대신 Alt+O로 변경하고 싶다고 가정해 봅시다. 먼저 "File: Open File" 명령을 검색하여 해당 명령 ID가 workbench.action.files.openFile임을 확인합니다. 그런 다음 keybindings.json 파일에 다음과 같이 추가합니다.

[
  {
    "key": "alt+o",
    "command": "workbench.action.files.openFile"
  }
]

만약 특정 확장 프로그램에서 제공하는 기능을 단축키로 설정하고 싶다면, 해당 확장 프로그램의 문서를 참조하여 명령 ID를 확인해야 합니다. 예를 들어, Prettier 확장 프로그램을 사용하여 코드를 자동으로 포맷하는 기능은 editor.action.formatDocument 명령 ID를 가집니다. 이를 Shift+Alt+F에 할당하는 것이 기본값이며, 이를 다른 단축키로 변경하고 싶다면 마찬가지로 keybindings.json에 추가하면 됩니다.

기존 단축키 변경 및 충돌 해결

VSCode 단축키 커스텀 설정 방법에서 중요한 부분 중 하나는 기존에 설정된 단축키를 변경하거나, 여러 설정 간에 발생할 수 있는 충돌을 해결하는 것입니다. VSCode는 사용자 설정, 확장 프로그램 설정, 그리고 기본 설정 등 여러 계층의 단축키 설정을 가집니다. 이들 간의 우선순위가 존재하며, 사용자가 직접 수정한 keybindings.json 파일의 설정이 일반적으로 가장 높은 우선순위를 가집니다.

기존 단축키를 변경하는 것은 새로운 단축키를 할당하는 것과 동일한 방식으로 keybindings.json 파일에 해당 명령 ID와 원하는 새로운 key 값을 지정하면 됩니다. 예를 들어, 코드 줄을 복사하는 기본 단축키 Ctrl+C (Windows/Linux) 또는 Cmd+C (macOS)를 다른 단축키로 바꾸고 싶다면, 해당 명령 ID(editor.action.copyLinesDownAction 또는 editor.action.copyLinesUpAction)를 찾아 keybindings.json에 새로운 키를 할당하면 됩니다.

단축키 충돌이 발생했을 때, VSCode는 어떤 단축키가 우선순위를 가지는지 시각적으로 보여줍니다. VSCode의 "키보드 바로 가기" 설정 화면에서 충돌하는 단축키를 검색하면, 해당 단축키에 여러 명령이 할당되어 있음을 확인할 수 있습니다. 이 화면에서 특정 명령에 대한 단축키를 제거하거나, 우선순위를 조정할 수 있습니다. 또한, when 절을 사용하여 특정 컨텍스트에서만 단축키가 작동하도록 설정함으로써 충돌을 피할 수 있습니다.

예를 들어, 특정 확장 프로그램에서 제공하는 단축키가 기본 단축키와 충돌하는 경우, 해당 확장 프로그램의 설정을 변경하거나, VSCode의 keybindings.json 파일에서 명시적으로 해당 명령에 대한 새로운 단축키를 할당하여 우선순위를 지정할 수 있습니다. when 절은 매우 강력한 기능으로, 예를 들어 텍스트 편집기에서만 특정 단축키가 작동하도록 하거나, 특정 파일 형식에서만 유효하도록 설정할 수 있습니다. 예를 들어, 다음과 같이 작성하면 해당 단축키는 텍스트 편집기 안에서만 유효합니다.

[
  {
    "key": "ctrl+shift+l",
    "command": "editor.action.selectAll",
    "when": "editorTextFocus"
  }
]

실제 사용자는 "Antigravity는 터미널 커맨드 완전 자동화 설정이 있는데, Codex는 없습니다. 그래서 매번 터미널 커맨드 실행시 물어보는데요. 이걸 아무리 다시 물어보지 않기를 선택해도 한계가 있습니다." 와 같이 특정 상황에서의 불편함을 언급하며, 이를 해결하기 위해 단축키 커스터마이징의 필요성을 느끼기도 합니다. (출처: clien.net) 이러한 상황에서 when 절을 활용하여 특정 컨텍스트에 맞는 단축키를 설정하는 것이 효과적입니다.

키맵 관리 및 효율적인 활용 팁

VSCode 단축키 커스텀 설정 방법은 단순히 단축키를 변경하는 것을 넘어, 장기적으로 개발 생산성을 유지하고 향상시키는 데 중요한 역할을 합니다. 자신에게 최적화된 단축키 설정을 효율적으로 관리하고 활용하는 것은 필수적입니다.

첫째, 단축키 설정을 백업하고 다른 환경에서 쉽게 적용할 수 있도록 관리하는 것이 중요합니다. VSCode의 설정 파일은 사용자 홈 디렉토리 내의 특정 폴더에 저장됩니다. Windows에서는 %APPDATA%\Code\User, macOS에서는 ~/Library/Application Support/Code/User 경로에 keybindings.json 파일이 저장됩니다. 이 파일을 Git과 같은 버전 관리 시스템으로 관리하거나, 클라우드 스토리지에 백업해두면 PC를 바꾸거나 VSCode를 재설치할 때 설정을 복원하기 용이합니다.

둘째, 단축키 설정을 너무 복잡하게 만들지 않는 것이 좋습니다. 너무 많은 사용자 정의 단축키는 오히려 기억하기 어렵게 만들고 혼란을 야기할 수 있습니다. 핵심은 자주 사용하는 기능에 대한 단축키를 직관적으로 설정하는 것입니다. VSCode는 기본적으로 Ctrl+K Ctrl+S (Windows/Linux) 또는 Cmd+K Cmd+S (macOS)와 같은 컨텍스트 메뉴를 통해 키 바인딩을 탐색하고 관리할 수 있는 기능을 제공합니다. 이를 활용하여 현재 할당된 단축키를 확인하고, 필요 없는 설정을 제거할 수 있습니다.

셋째, VSCode의 확장 프로그램을 활용하여 단축키 설정을 더욱 강화할 수 있습니다. 예를 들어, "Settings Sync"와 같은 확장 프로그램은 여러 VSCode 인스턴스 간에 설정, 키 바인딩, 확장 프로그램 등을 동기화하는 기능을 제공합니다. 이를 통해 여러 컴퓨터에서 동일한 개발 환경을 유지할 수 있습니다. 또한, 특정 키맵을 제공하는 확장 프로그램도 존재하며, 이를 설치하면 유명한 IDE(예: IntelliJ, Sublime Text)의 단축키를 VSCode에서 사용할 수 있게 해줍니다. 예를 들어, "VSCodeVim" 확장 프로그램을 설치하면 Vim의 키 바인딩을 VSCode에서 사용할 수 있습니다.

마지막으로, 단축키 설정은 주기적으로 검토하고 최적화하는 것이 좋습니다. 개발 환경은 계속 변화하고, 새로운 확장 프로그램을 설치하거나 작업 방식이 바뀔 수 있습니다. 따라서 정기적으로 자신의 단축키 설정을 검토하고, 더 효율적인 방법이 있는지, 불필요한 설정은 없는지 확인하는 과정이 필요합니다. 예를 들어, 특정 기능에 대한 단축키가 잘 사용되지 않는다면 제거하거나, 더 자주 사용하는 기능에 할당하는 것을 고려해 볼 수 있습니다.