VSCode 단축키 충돌? 나만의 커스텀 설정으로 해결

VSCode에서 코드 작업에 집중하려는데, 자주 쓰는 단축키가 다른 프로그램 단축키와 겹쳐 자꾸 엉뚱한 기능이 실행되거나, 매번 필요한 기능을 검색해서 클릭해야 했던 경험 있으신가요? 이는 VSCode의 기본 설정이 모든 사용자의 작업 환경이나 개인적인 작업 방식을 만족시키기 어렵기 때문에 발생하는 흔한 문제입니다.

하지만 걱정할 필요 없습니다. VSCode는 이런 불편함을 해결할 수 있도록 매우 유연한 단축키 커스터마이징 기능을 제공합니다. 이 글에서는 VSCode의 강력한 단축키 커스텀 기능을 활용해 충돌을 해결하고, 나만의 생산적인 개발 환경을 구축하는 구체적인 방법을 단계별로 안내합니다.

VSCode 단축키, 왜 나만 충돌할까?

VSCode는 수많은 개발자가 사용하는 강력한 도구지만, 기본 단축키는 때때로 개발자의 작업 흐름을 방해할 수 있습니다. 특히 크롬, 한글, IDE 등 다른 프로그램과 동시에 사용할 때 `Ctrl+Shift+L` 같은 흔한 조합이 충돌을 일으키곤 합니다. 이로 인해 코드 작업에 집중하려다 엉뚱한 기능이 실행되는 불편함을 겪게 됩니다.

이러한 충돌은 VSCode의 기본 설정이 사용자의 로컬 환경이나 개인적인 작업 방식까지 모두 커버하지 못하기 때문에 발생합니다. 예를 들어, 어떤 개발자는 파이썬 환경에서 특정 단축키를 자주 쓰지만, 다른 개발자는 자바스크립트 환경에서 완전히 다른 단축키를 선호하기도 합니다. 개인화된 요구사항을 기본 설정만으로는 충족시키기 어렵죠.

하지만 걱정할 필요 없습니다. VSCode는 이런 문제를 해결할 수 있도록 매우 유연한 단축키 커스터마이징 기능을 제공합니다. 이 기능을 이해하고 활용하면, 불편했던 단축키 충돌을 3분 안에 해결하고 나만의 최적화된 개발 환경을 만들 수 있습니다.

Photo by Zayed Hossain on Pexels

나만의 단축키 설정, `keybindings.json` 완전 정복

VSCode 단축키를 사용자 지정하는 핵심은 바로 `keybindings.json` 파일입니다. 이 파일은 모든 사용자 정의 단축키 설정이 저장되는 곳이며, 코드를 통해 원하는 단축키를 추가하거나 수정할 수 있습니다. 마치 나만의 맞춤형 명령어를 만드는 것과 같습니다.

`keybindings.json` 파일을 여는 방법은 간단합니다. VSCode에서 `Ctrl+K Ctrl+S` (macOS는 `Cmd+K Cmd+S`)를 누르거나, 메뉴에서 ‘파일 > 기본 설정 > 바로 가기 키’를 선택합니다. 열린 화면의 오른쪽 상단 ‘바로 가기 키 열기(JSON)’ 아이콘을 클릭하면 `keybindings.json` 파일이 열립니다. 기본적으로 VSCode는 2,000개 이상의 다양한 명령어를 지원합니다.

이 파일은 JSON 형식으로 이루어져 있습니다. 각 단축키는 객체 형태로 `key`, `command`, `when` 세 가지 주요 속성을 가집니다. `key`는 누를 단축키 조합을, `command`는 해당 단축키가 실행할 VSCode 명령어를, `when`은 단축키가 동작할 조건을 정의합니다.

1. `keybindings.json` 파일 열기 — `Ctrl+K Ctrl+S` 또는 ‘파일 > 기본 설정 > 바로 가기 키’ 메뉴를 통해 설정 화면에 접근한 뒤, 우측 상단의 `{ }` 아이콘을 클릭하여 JSON 파일을 엽니다.
2. 기본 형식 이해 — `keybindings.json` 파일은 JSON 배열(`[]`)로 시작하며, 각 단축키 설정은 `{}` 객체 형태로 배열 안에 들어갑니다. 기존에 설정된 것이 없다면 빈 배열(`[]`)로 시작합니다.
3. 단축키 추가 예시 — `{ “key”: “ctrl+d”, “command”: “editor.action.deleteLines”, “when”: “editorTextFocus” }` 와 같이 `key`, `command`, `when` 속성을 채워넣습니다. 이는 `Ctrl+D`를 눌렀을 때 텍스트 에디터에 포커스가 있다면 현재 줄을 삭제하라는 명령입니다.

Photo by Muhammed Ensar on Pexels

단축키 충돌 해결 및 추가: 실전 가이드

이제 실제 단축키 충돌을 해결하고 새로운 단축키를 추가하는 방법을 알아보겠습니다. 예를 들어, `Ctrl+D` 단축키가 다른 프로그램과 충돌하여 VSCode에서 줄 삭제 대신 다른 기능이 실행될 때, 이를 `Ctrl+Alt+D`로 변경하고 싶다면 `keybindings.json`에 다음과 같이 설정할 수 있습니다:

`[ { “key”: “ctrl+alt+d”, “command”: “editor.action.deleteLines”, “when”: “editorTextFocus” } ]` 이렇게 설정하면, `Ctrl+D`는 더 이상 충돌하지 않고 새로운 `Ctrl+Alt+D`가 줄 삭제 기능을 수행하게 됩니다. 먼저, VSCode 단축키 설정 창(`Ctrl+K Ctrl+S`)에서 문제가 되는 기존 단축키를 검색해 어떤 명령과 연결되어 있는지 확인하는 것이 좋습니다.

단순히 새로운 기능을 추가하는 것도 매우 유용합니다. 예를 들어, 특정 확장 프로그램이 제공하는 자주 쓰는 명령이지만 단축키가 지정되어 있지 않다면, `keybindings.json`에 직접 추가하여 효율을 80% 이상 끌어올릴 수 있습니다. 예를 들어, ‘파일 저장 후 포맷’ 같은 복합 명령도 하나의 단축키로 만들 수 있습니다.

Photo by Bibek ghosh on Pexels

생산성을 높이는 고급 단축키 활용 팁

`when` 절을 활용하면 단축키의 적용 범위를 정교하게 제어할 수 있습니다. 예를 들어, 특정 파일 형식(`when: ‘resourceExtname == .js’`)이나 특정 UI 요소에 포커스가 있을 때만(`when: ‘editorTextFocus’`) 단축키가 작동하도록 설정할 수 있습니다. 이는 충돌을 최소화하고 문맥에 맞는 단축키 사용을 가능하게 하여 작업 흐름을 더욱 원활하게 만듭니다.

여러 명령을 연속으로 실행하는 ‘매크로’ 같은 단축키는 직접 설정하기 어렵지만, ‘Multi-command’ 같은 확장 프로그램을 활용하면 가능합니다. 예를 들어 ‘모든 파일 저장 후 터미널 빌드’와 같은 2~3단계 작업을 하나의 단축키로 만들어 번거로운 과정을 자동화할 수 있습니다. 이는 반복적인 작업을 줄여 개발 시간을 절약하는 데 크게 기여합니다.

또한, 기본 단축키 중 자주 사용하지 않는 기능을 비활성화할 수도 있습니다. `keybindings.json`에 `{ “key”: “원하는_키_조합”, “command”: “-기존_명령어” }` 와 같이 `-`를 붙여 해당 단축키 바인딩을 제거하면 됩니다. 이 방법으로 불필요한 단축키를 최대 50개까지 비활성화하여 오작동을 줄이고, 나만의 간결한 단축키 환경을 구축할 수 있습니다.