VSCode 맥북 세팅(입문) : 설치부터 한글 입력, 필수 확장 10개까지 한 번에

처음 VSCode를 켰는데 한글 입력이 버벅이거나, 터미널이 낯설고, 확장을 뭘 깔아야 할지 막막하죠.

이 글은 “입문자 기준”으로 VSCode 맥북 세팅을 한 번에 끝내는 흐름입니다. 

설치 → 한글 입력/단축키 충돌 → 폰트/테마 → 필수 확장 10개 → 추천 설정까지, 오늘 세팅해 두면 다음 글(Settings Sync, 터미널, Git)로 넘어갈 때 더 이상 안 막힙니다.

0. 5분 완성 체크리스트(먼저 이것만)

아래 6가지만 먼저 맞추면, 대부분의 “입문자 지뢰”가 사라집니다. (특히 VSCode 맥북 세팅에서 한글/단축키 충돌이 가장 흔해요.)

항목	추천 값	왜 중요한가
설치	공식 VSCode + 자동 업데이트	버그/입력기 이슈가 업데이트로 해결되는 경우가 많음
한글 입력	IME 충돌 단축키 정리	한/영 전환·자동완성 단축키 충돌이 주범
폰트	영문 고정폭 + 한글 가독성	코드 정렬/한글 주석 가독성 체감 큼
터미널	zsh + 기본 폰트/인코딩	한글 깨짐/명령 실행 실패를 줄임
필수 확장	10개만 먼저	확장 과다 설치는 느려짐/충돌 원인
설정	저장 시 포맷 + 자동 저장	팀/프로젝트에서 바로 “깔끔한 코드” 유지

1) VSCode 설치(맥) + “code” 명령까지

1-1. 설치는 공식 앱으로(가장 깔끔)

• VSCode 설치 후 실행
• 자동 업데이트: 기본값 유지(특별히 막아야 할 이유가 없다면 켜두는 편이 안전)

1-2. 터미널에서 “code .” 사용하기

1. VSCode 상단 메뉴: View → Command Palette…
2. Shell Command: Install 'code' command in PATH 실행
3. 터미널 재실행 후 폴더에서 code .

이 한 번을 해두면 앞으로 프로젝트 폴더에서 바로 VSCode를 열 수 있어 VSCode 맥북 세팅 효율이 급상승합니다.

2) 한글 입력이 안 되거나 느릴 때(단축키 충돌 80% 해결)

2-1. “한/영 전환”과 “자동완성 단축키” 충돌부터 체크

• macOS 입력 소스 전환 단축키(예: Ctrl+Space, Cmd+Space)를 쓰는 경우, VSCode 내부 단축키와 충돌할 수 있어요.
• 증상: 한글 조합이 끊기거나, 후보창이 이상하게 뜨거나, 입력이 딜레이 됨

2-2. 가장 많이 먹히는 설정(입문자 추천)

• Keyboard Dispatch를 안정적으로: Settings에서 keyboard.dispatch 검색 → keyCode로 변경(단축키 인식이 꼬일 때 도움)
• 한/영 전환 단축키를 OS에서 확실히 한 개로 고정(서드파티 입력기/키보드 앱이 있다면 중복 제거)
• VSCode 확장 중 키바인딩을 많이 건 확장(예: Vim 계열)을 설치했다면, 한글 입력 안정화 후에 추가

핵심은 “입력기(IM) + VSCode 단축키 + 확장 키바인딩” 3자 충돌을 끊는 겁니다. 이 단계만 정리해도 VSCode 맥북 세팅에서 가장 답답한 구간(한글 입력)이 풀리는 경우가 많습니다.

3) 폰트/테마 추천(가독성은 생산성)

3-1. 폰트 추천 조합

• 영문: JetBrains Mono / SF Mono 계열
• 한글 주석이 많은 경우: 한글 가독성 좋은 고정폭 폰트(예: D2Coding 계열)를 함께 사용

3-2. 입문자용 테마 팁

• 다크 테마: 눈 피로 줄이기(장시간 코딩 시 체감 큼)
• 아이콘 테마: 파일 타입을 빠르게 구분

4) 필수 확장 10개(입문 → 실전 최소 구성)

확장은 “많을수록 좋다”가 아니라 “충돌/무거움이 늘어난다”가 현실입니다. 아래 10개만 먼저 설치하면, 대부분의 입문 프로젝트에서 충분합니다. (나중에 필요할 때 추가)

1. Korean Language Pack (메뉴 한글화가 필요하면)
2. GitLens (누가/언제 수정했는지, Git 히스토리 시각화)
3. Prettier (저장 시 코드 포맷)
4. ESLint (JS/TS 린트로 실수 예방)
5. Python (파이썬 개발 필수)
6. Pylance (Python 타입/자동완성 강화)
7. Jupyter (노트북 작업이 있다면)
8. Docker (컨테이너 환경/학습용)
9. Remote - SSH (서버/원격 개발 대비)
10. Markdown All in One (README/문서 작성 편의)

위 구성이 “코어”입니다. 이 정도면 VSCode 맥북 세팅은 입문자 기준으로 거의 완성이고, 이후 글(Settings Sync, 터미널 기본기, Git 입문)로 확장하면 됩니다.

▼ VSCode 공식 다운로드로 이동하기 ▼

5) 추천 Settings.json(입문자 기본값)

5-1. 저장 시 자동 포맷(실수 줄이기)

Settings(⌘,)에서 아래 항목을 검색해 켜두면, “팀 프로젝트에서 민망한 포맷 깨짐”을 미리 막습니다.

• Format On Save: On
• Auto Save: afterDelay(취향)
• Default Formatter: Prettier(웹) / Python formatter(파이썬)

5-2. 입문자에게 추천하는 ‘무난한’ 편의 설정

• Editor: Minimap 끄기(작은 화면에서 공간 확보)
• Editor: Font Size 13~15(눈에 맞게)
• Terminal: Font Family를 에디터와 동일하게 맞추기(깨짐 감소)

6) 자주 막히는 오류 Top 5(초보용 빠른 처방)

• “code: command not found” → 1-2의 PATH 설치 다시 실행
• 한글 조합이 끊김 → 2장의 단축키 충돌 정리 + keyboard.dispatch 점검
• 저장할 때 포맷이 안 됨 → Prettier 설치/기본 포매터 지정 확인
• 터미널에서 한글 깨짐 → 폰트/인코딩, zsh 환경(다음 글에서 심화)
• 확장 설치 후 느려짐 → 확장 과다/겹치는 린터(ESLint+다른 린터) 정리

함께 보면 좋은 글

① Homebrew 2026 설치 가이드: brew command not found/권한 오류까지 한 번에 해결(맥북)

VSCode에서 터미널을 제대로 쓰려면 Homebrew가 거의 필수입니다. “brew not found”나 권한 오류로 막혔다면 이 글부터 정리하세요.

→ 바로 읽기

함께 보면 좋은 글

② Git 설치 & 초기 설정 2026: user.name/email, 기본 브랜치(main), 줄바꿈(LF/CRLF)까지 한 번에

VSCode에서 Git을 쓰려면 “설치 + 초기값(user.name/email, main, 줄바꿈)”이 먼저 잡혀 있어야 충돌/푸시 오류가 줄어듭니다.

→ 바로 읽기

함께 보면 좋은 글

③ GitHub SSH Key 세팅 2026: 비밀번호 없이 push/pull 하는 법 (권한 오류 Top 7)

VSCode에서 커밋/푸시까지 막힘 없이 가려면 SSH 키가 정답입니다. 비밀번호 반복 입력, Permission denied 오류를 한 번에 정리합니다.

→ 바로 읽기

FAQ: VSCode 맥북 세팅(입문)에서 가장 많이 묻는 것

Q1. VSCode에서 한글 입력이 느리거나 조합이 끊겨요. 가장 먼저 뭘 보나요?

A. 대부분은 “단축키 충돌”이 원인입니다. macOS의 입력 소스 전환(한/영) 단축키가 VSCode의 자동완성/검색/변환 단축키와 겹치면 한글 조합이 끊기거나 딜레이가 생길 수 있어요. OS에서 한/영 전환 단축키를 1개로 정리하고, VSCode 설정에서 keyboard.dispatch를 keyCode로 바꾼 뒤, 키바인딩을 과하게 건 확장(Vim 계열 등)은 한글이 안정화된 다음에 추가하는 순서가 안전합니다.

Q2. 필수 확장은 딱 뭐부터 깔아야 하나요? (너무 많아서 혼란)

A. 입문 단계에서는 “포맷/린트/언어 지원/버전관리/문서”만 있으면 충분합니다. 그래서 Prettier, ESLint(웹), Python+Pylance(파이썬), GitLens, Markdown All in One을 코어로 잡고, 필요할 때만 Jupyter(노트북), Docker(컨테이너), Remote-SSH(원격)를 더하는 흐름이 좋아요. 확장을 과하게 설치하면 시작 속도가 느려지거나, 같은 역할의 확장이 충돌해 오히려 문제가 생기기도 합니다. VSCode 맥북 세팅은 “최소 구성→필요 시 추가”가 정답입니다.

Q3. “code .”가 안 돼요. 설치는 했는데 터미널에서 명령이 없다고 나옵니다.

A. VSCode 앱 설치와 “터미널 명령”은 별개입니다. VSCode에서 Command Palette를 열고 “Shell Command: Install 'code' command in PATH”를 실행하면, 터미널에서 code 명령을 인식하도록 PATH에 등록됩니다. 실행 후에는 터미널을 완전히 종료했다가 다시 열어야 반영되는 경우가 많아요. 그래도 안 되면 zsh 설정이나 PATH 중복이 원인일 수 있으니, 다음 단계로 VSCode 터미널 기본기 글에서 PATH/쉘 설정을 함께 점검하는 걸 추천합니다.

마무리: 오늘 세팅이 끝나면, 다음 단계는 “동기화”

이 글에서 VSCode 맥북 세팅을 끝냈다면, 다음은 Settings Sync로 “새 맥북에서도 5분 복구”를 만들어 두는 겁니다. 한 번만 해두면 확장/설정/키바인딩이 자동으로 따라옵니다.