VSCode 맥 단축키, 내 손에 딱 맞게 완벽 설정하는 법

VSCode에서 +Space를 눌러 자동완성을 시도하는데 자꾸 맥 Spotlight 검색창이 튀어나와 작업 흐름이 끊기거나, 윈도우 환경처럼 나만의 단축키를 설정하고 싶었던 경험, 아마 많은 분이 공감하실 겁니다.

이러한 불편함은 맥 운영체제의 기본 단축키와 VSCode의 주요 기능 단축키가 겹치면서 발생하는 고질적인 문제입니다.

이 글에서는 VSCode와 맥 시스템 단축키 충돌을 깔끔하게 해결하고, 나아가 나만의 작업 스타일에 맞춰 단축키를 완벽하게 커스터마이징하는 방법을 단계별로 상세히 안내해 드리겠습니다.

맥 시스템 단축키 충돌, 왜 문제일까요?

대부분의 개발자가 VSCode와 같은 편집기에서 +Space를 자동완성 또는 코드 제안(IntelliSense) 호출 단축키로 활용하곤 합니다. 하지만 맥 운영체제에서는 이 단축키가 시스템 전반의 검색 기능인 Spotlight를 실행하도록 기본 설정되어 있습니다.

이러한 충돌은 개발자의 작업 흐름을 끊고 불필요한 맥락 전환을 유발하여 생산성을 저해하는 주요 원인이 됩니다. VSCode 내부에서 아무리 단축키를 변경해도 시스템 단축키가 우선권을 가지기 때문에 근본적인 해결책이 필요합니다.

+Space 외에도 맥의 Mission Control, Spaces 이동 등 시스템 기본 단축키 중 일부가 VSCode 내 다른 유용한 기능과 겹칠 수 있습니다. 예를 들어 +Tab은 앱 전환에 사용되지만, 간혹 다른 탭 관련 단축키와 혼동되기도 합니다. 이런 사소한 충돌이 쌓이면 개발자는 잦은 불편함을 겪게 됩니다.

VSCode 단축키 설정 기본 가이드 (GUI 활용)

VSCode는 직관적인 GUI 기반의 단축키 편집기를 제공하여 초보자도 쉽게 자신만의 단축키를 설정할 수 있도록 돕습니다. 다음 3단계 과정만 거치면 기본적인 단축키 설정은 충분히 가능합니다.

1. 단축키 편집기 열기 — VSCode에서 K S (K를 누른 후 S를 순서대로 누름)를 누르거나, 메뉴바에서 ‘Code > 기본 설정 > 바로 가기 키’를 선택하여 단축키 편집기를 엽니다. 이곳에서 현재 설정된 모든 단축키 목록을 확인할 수 있습니다.
2. 명령어 검색 및 단축키 확인 — 검색창에 ‘spotlight’, ‘autocomplete’, ‘intellisense’ 등 원하는 기능과 관련된 키워드를 입력하여 관련 명령어를 찾습니다. 각 명령어 옆에는 현재 할당된 단축키가 표시됩니다.
3. 단축키 변경 및 추가 — 변경하고 싶은 명령어의 단축키 부분을 클릭한 후, 원하는 단축키 조합을 누릅니다. 예를 들어 Spotlight와 충돌하는 ‘Trigger Suggest’ 명령어를 찾은 후, +I와 같이 새 단축키를 지정할 수 있습니다. 이미 사용 중인 단축키라면 충돌 경고가 표시되니 참고하세요.

이렇게 GUI를 통해 단축키를 변경하면, `keybindings.json` 파일에 자동으로 해당 설정이 추가되어 관리됩니다. 약 5분 정도만 투자하면 기본적인 충돌 해결과 함께 자신에게 익숙한 단축키로 VSCode를 사용할 수 있습니다.

나만의 단축키, keybindings.json으로 완벽 제어하기

VSCode의 단축키 편집기는 편리하지만, 특정 상황(when)에서만 작동하도록 하거나, 여러 단축키 조합을 통해 하나의 명령어를 실행하는 등 좀 더 복잡하고 정교한 설정은 `keybindings.json` 파일을 직접 수정해야 가능합니다. 이 파일은 VSCode 단축키 설정의 ‘본진’이라고 할 수 있습니다.

단축키 편집기에서 오른쪽 상단의 `{}` 아이콘을 클릭하면 `keybindings.json` 파일을 열 수 있습니다. 이 파일에는 사용자가 커스터마이징한 단축키 설정이 JSON 형식으로 저장됩니다. 각 항목은 `key`, `command`, `when` 세 가지 주요 속성을 가집니다.

`keybindings.json`의 예시를 살펴보면, `{ “key”: “cmd+space”, “command”: “editor.action.triggerSuggest”, “when”: “editorTextFocus” }`와 같이 구성됩니다. 여기서 `key`는 단축키 조합, `command`는 실행할 명령어 ID, `when`은 해당 단축키가 활성화될 조건(예: 텍스트 편집기에 포커스가 있을 때)을 나타냅니다. `when` 절은 수십 가지 이상의 다양한 조건을 조합할 수 있어 매우 강력한 커스터마이징이 가능합니다.

단축키 설정 시 유용한 팁과 주의사항

VSCode 단축키를 커스터마이징할 때는 몇 가지 유용한 팁을 활용하고 주의사항을 숙지하면 더욱 효율적으로 작업할 수 있습니다. 특히 명령어 ID를 찾는 방법과 기존 단축키를 비활성화하는 방법을 알아두면 매우 편리합니다.

1. 명령어 ID 찾기 — 단축키 편집기에서 원하는 명령어를 검색한 후, 해당 명령어에 마우스를 올리면 툴팁으로 명령어 ID를 확인할 수 있습니다. `keybindings.json`에 직접 추가할 때 이 ID가 필요합니다.
2. 기존 단축키 비활성화 — 특정 단축키를 시스템 기본값이나 확장 기능 단축키보다 우선시하고 싶지 않다면, `keybindings.json` 파일에 `{“key”: “cmd+space”, “command”: “-editor.action.triggerSuggest”}`와 같이 `-`를 붙여 해당 명령어를 비활성화할 수 있습니다. 이는 특히 여러 확장 기능 설치 시 발생하는 단축키 충돌 해결에 효과적입니다.
3. 확장 기능 단축키 확인 — 설치한 확장 기능이 특정 단축키를 점유하는 경우가 많습니다. 단축키 편집기에서 `@source:ext`를 입력하면 확장 기능이 제공하는 단축키를 필터링하여 볼 수 있습니다.

새로운 단축키를 지정할 때는 가급적 시스템이나 다른 주요 응용 프로그램과 겹치지 않는 조합을 선택하는 것이 좋습니다. 또한, 복잡한 조합보다는 직관적이고 외우기 쉬운 단축키를 우선적으로 설정하여 작업 효율을 극대화하세요.