VSCode에서 자동완성을 위해 ⌘ + Space를 눌렀는데, 느닷없이 Spotlight 검색창이 떠서 불편했던 경험 있으신가요?
이는 맥 운영체제의 기본 단축키와 VSCode의 기본 단축키가 겹치면서 발생하는 흔한 문제입니다.
이 글에서는 이런 단축키 충돌을 해결하고, 나아가 개발 효율을 30% 이상 높이는 VSCode 맥 단축키 사용자 설정 방법을 단계별로 안내합니다.
– 맥 시스템 단축키와 VSCode 단축키의 충돌 원인 및 해결책을 제시합니다.
– VSCode 단축키 설정 UI를 활용해 단축키를 변경하거나 삭제하는 방법을 안내합니다.
– keybindings.json 파일을 통한 고급 사용자 정의 설정과 효율적인 단축키 조합을 제안합니다.
VSCode 맥 단축키가 시스템과 충돌할 때, 이를 해결하고 나만의 방식으로 효율적인 키 바인딩을 설정하는 방법을 알려드립니다.
⌘ + Space 충돌, 왜 발생할까요? (맥 시스템과의 이해)
맥 환경에서 VSCode를 사용하다 보면 특정 단축키가 제대로 작동하지 않거나, 예상치 못한 시스템 기능이 실행되는 경우가 있습니다. 대표적인 예가 ⌘ + Space 단축키입니다. 이 조합은 VSCode에서 자동 완성 기능을 트리거하는 데 자주 사용되지만, 맥 운영체제에서는 Spotlight 검색창을 띄우는 역할을 합니다.
이러한 충돌은 운영체제 수준에서 설정된 단축키가 응용 프로그램의 단축키보다 우선순위를 갖기 때문에 발생합니다. 즉, VSCode가 아무리 특정 단축키를 사용하도록 지정했어도, 맥 시스템이 먼저 해당 단축키를 가로채 실행해버리는 것입니다. 이로 인해 개발 흐름이 자주 끊기고 불편함이 가중됩니다.
문제 해결을 위해서는 맥 시스템의 단축키 설정을 변경하거나, VSCode 내에서 충돌 단축키를 재정의해야 합니다. 일반적으로 맥 시스템 단축키를 변경하는 것이 더 근본적인 해결책이 될 수 있습니다.
맥 시스템 단축키를 변경할 경우, 다른 응용 프로그램에서도 해당 단축키의 기능이 달라질 수 있습니다. 변경 전 충분히 고려하고, 필요한 경우 대체 단축키를 미리 숙지하는 것이 좋습니다.
Photo by Arjunn. la on Pexels
VSCode 단축키 설정, GUI로 손쉽게 해결하기
가장 직관적인 방법은 VSCode의 내장 단축키 설정 UI를 활용하는 것입니다. 이 방법은 복잡한 설정 파일 편집 없이 시각적으로 단축키를 관리할 수 있어 초보자도 쉽게 접근할 수 있습니다.
먼저 VSCode 단축키 설정창을 엽니다. 메뉴 바에서 Code > 기본 설정 > 바로 가기 키 열기를 선택하거나, ⌘ + K를 누른 뒤 바로 ⌘ + S를 눌러 빠르게 접근할 수 있습니다. 단축키 설정창은 검색 기능과 함께 현재 설정된 모든 단축키 목록을 보여줍니다.
여기서 충돌하는 ⌘ + Space 단축키를 찾아 VSCode 내에서의 동작을 변경하거나 제거할 수 있습니다. 예를 들어, 자동 완성 단축키를 ⌥ + Space나 ⌃ + Space 등으로 변경하면 Spotlight와 충돌 없이 사용할 수 있습니다.
- 단축키 설정 열기 — VSCode에서
⌘ + K, 이어서⌘ + S를 누릅니다. - 충돌 단축키 검색 — 검색창에
⌘ + Space또는 `trigger suggest`를 입력하여 관련 단축키를 찾습니다. - 단축키 재할당/삭제 — 찾은 단축키 항목에 마우스 오른쪽 버튼을 클릭하여 `키 바인딩 변경` 또는 `키 바인딩 제거`를 선택합니다. 새로운 단축키를 입력하고 Enter를 누르면 변경이 완료됩니다.
Photo by Startup Stock Photos on Pexels
keybindings.json으로 나만의 단축키 마스터하기 (고급 설정)
VSCode의 단축키 설정 UI는 편리하지만, 더 세밀한 조건과 복잡한 단축키 조합을 설정하고 싶다면 keybindings.json 파일을 직접 편집하는 것이 훨씬 강력합니다. 이 JSON 파일은 특정 컨텍스트(`when` 절)에서만 단축키가 작동하도록 설정하는 등 고급 기능을 제공합니다.
keybindings.json 파일은 단축키 설정 UI의 우측 상단에 있는 `{}` 아이콘을 클릭하여 열 수 있습니다. 이 파일에 추가하는 설정은 기본 단축키 설정을 덮어쓰게 됩니다. 따라서 기존 시스템 충돌 단축키를 완전히 무력화시키고 원하는 기능을 부여하는 것이 가능합니다.
예를 들어, ⌘ + Space 단축키가 VSCode 내에서 아무런 동작도 하지 않도록 하려면 다음과 같이 빈 명령어를 할당할 수 있습니다. 또한, 터미널 토글이나 특정 파일 포맷팅과 같이 자주 사용하는 명령에 사용자 정의 단축키를 할당하여 작업 흐름을 최적화할 수 있습니다.
| 구분 | 설명 | 예시 (keybindings.json) |
|---|---|---|
key |
사용할 단축키 조합 ("cmd+space") |
"key": "cmd+space" |
command |
해당 단축키가 실행할 VSCode 명령어 ("editor.action.triggerSuggest") |
"command": "workbench.action.terminal.toggleTerminal" |
when |
단축키가 활성화될 조건 (특정 에디터, 파일 타입 등) | "when": "editorTextFocus" |
Photo by Paras Katwal on Pexels
개발 생산성을 높이는 맥 사용자 추천 단축키
단축키 충돌 해결을 넘어, 몇 가지 유용한 단축키들을 익히면 개발 생산성을 크게 높일 수 있습니다. 특히 맥 사용자는 시스템 단축키와 겹치지 않으면서도 VSCode의 강력한 기능을 활용할 수 있는 조합을 찾는 것이 중요합니다. 다음은 많은 개발자가 추천하는 5가지 핵심 단축키입니다.
1. 터미널 토글: ⌃ + ` (백틱) – 내장 터미널을 빠르게 열고 닫을 수 있습니다. 마우스 없이 명령줄 작업을 할 때 필수적입니다.
2. 파일 탐색기 토글: ⌘ + B – 사이드바의 파일 탐색기를 열고 닫아 작업 영역을 넓힐 수 있습니다.
3. 모든 명령 팔레트: ⌘ + Shift + P – VSCode의 모든 명령을 검색하고 실행할 수 있는 만능 단축키입니다. 어떤 기능을 찾아야 할지 모를 때 유용합니다.
4. 현재 파일 포맷팅: ⇧ + ⌥ + F – 코드를 일관된 스타일로 자동으로 정렬하여 가독성을 높여줍니다.
5. 라인 복제: ⇧ + ⌥ + ↓ (아래 방향키) 또는 ⇧ + ⌥ + ↑ (위 방향키) – 현재 라인을 빠르게 복제하여 반복적인 코드 작성 시간을 절약합니다.
새로운 단축키를 한 번에 모두 외우려 하지 마세요. 자주 사용하는 2~3개부터 시작하여 일주일간 꾸준히 사용하면 손에 익게 됩니다. 점진적으로 익히는 것이 효과적인 학습 방법입니다.
맥 VSCode 단축키 충돌은 시스템 단축키 우선순위 때문에 발생하며, 이를 해결하기 위해 VSCode GUI 또는 keybindings.json 파일을 통해 단축키를 재설정할 수 있습니다.
자신만의 효율적인 단축키 조합을 구축하면 개발 생산성을 획기적으로 향상시킬 수 있습니다.
지금 바로 적용해 보세요.
- Visual Studio Code Keybindings — VSCode 공식 문서의 단축키 관련 페이지입니다.
- Mac의 키보드 단축키 사용자화 — Apple 지원 문서로, 맥 시스템 단축키를 변경하는 방법을 설명합니다.
동영상으로 보는 VSCode 맥 단축키 충돌 해결 및 사용자 설정
글로 충분하지 않다면 관련 영상을 함께 보세요. 클릭하면 YouTube에서 검색 결과로 이동합니다.
자주 묻는 질문
Q. VSCode 단축키가 맥 시스템 단축키와 충돌하는 주된 이유는 무엇인가요?
A. 맥 운영체제는 스크린샷, 미션 컨트롤 등 시스템 전반의 특정 기능을 위해 일부 키 조합을 예약해 둡니다. VSCode가 이와 동일한 조합을 사용하려고 할 때, 시스템 단축키가 우선권을 가지므로 VSCode 명령이 실행되지 않고 충돌이 발생합니다. 이는 주로 Command, Option, Control, Shift가 포함된 조합에서 빈번하게 나타납니다.
Q. 어떤 단축키가 충돌을 일으키고 있는지 어떻게 확인할 수 있나요?
A. VSCode의 “키보드 단축키” 편집기(Cmd+K Cmd+S)에서 특정 키 바인딩을 검색하여 충돌 여부를 확인할 수 있습니다. 여기서 두 개 이상의 명령이 동일한 단축키를 사용하고 있는지 확인하거나, 특정 단축키를 눌렀을 때 예상한 VSCode 명령이 실행되지 않는 경우 충돌을 의심할 수 있습니다. 시스템 단축키와의 충돌은 맥 시스템 설정에서 직접 확인하는 것도 한 방법입니다.
Q. 충돌 없이 VSCode 단축키를 사용자 정의하는 가장 좋은 방법은 무엇인가요?
A. VSCode의 “키보드 단축키” 편집기를 사용하여 충돌하는 VSCode 단축키를 해제하거나 사용 빈도가 낮은 다른 키 조합으로 재할당하는 것이 가장 안전합니다. 시스템 단축키와의 충돌은 맥의 시스템 설정(키보드 > 키보드 단축키)에서 시스템 단축키를 변경하거나, VSCode에서 완전히 새로운 키 바인딩을 지정하여 해결할 수 있습니다. 자주 사용하는 기능에는 고유하고 기억하기 쉬운 단축키를 우선적으로 할당하는 것이 좋습니다.
Q. 사용자 정의한 VSCode 단축키 설정을 다른 맥 컴퓨터와 동기화할 수 있나요?
A. 네, 가능합니다. VSCode의 “설정 동기화(Settings Sync)” 기능을 활용하면 로그인된 모든 기기에서 단축키, 설정, 확장 프로그램 등을 동기화할 수 있습니다. 이 기능은 VSCode 좌측 하단의 톱니바퀴 아이콘을 통해 활성화할 수 있으며, 수동으로 `keybindings.json` 파일을 복사하여 적용하는 방법도 있습니다.
📚 함께 읽으면 좋은 글