Visual Studio Code 최적 세팅 방법 – settings.json 기본 세팅 예제 정리

Visual Studio Code(VSCode)는 기본 설정만으로도 충분히 사용할 수 있지만, settings.json 파일을 통해 개인에 맞는 최적화된 개발 환경을 만들 수 있습니다. 오늘은 실무에서 자주 사용하는 VSCode 기본 세팅 예제를 정리해 소개합니다.

settings.json이란?

settings.json은 VSCode의 세부 설정을 담는 파일입니다. UI를 통해 설정할 수도 있지만, 직접 JSON 파일을 수정하면 더 빠르고 세밀한 설정이 가능합니다. 사용자 설정(User Settings)과 작업 영역 설정(Workspace Settings)으로 나뉘며, 여기서는 사용자 설정 기준으로 설명합니다.

settings.json 파일 여는 방법

1. VSCode 오른쪽 하단 톱니바퀴 클릭
2. 설정(Settings) → 우측 상단 {} 아이콘 클릭
3. settings.json 파일 열림

또는 단축키 Ctrl + Shift + P를 누른 후, "Preferences: Open Settings (JSON)"을 검색해 바로 열 수 있습니다.

추천 기본 세팅 예제

다음은 대부분의 개발자가 유용하게 사용하는 기본 세팅입니다.

{
    "editor.tabSize": 4,
    "editor.insertSpaces": true,
    "editor.wordWrap": "on",
    "files.autoSave": "onFocusChange",
    "editor.formatOnSave": true,
    "editor.codeActionsOnSave": {
        "source.fixAll": true
    },
    "terminal.integrated.fontSize": 13,
    "workbench.startupEditor": "none",
    "breadcrumbs.enabled": true
}

세팅 항목 설명

• editor.tabSize: 탭을 4칸 들여쓰기로 설정합니다.
• editor.insertSpaces: 탭 대신 공백(space)으로 들여쓰기를 합니다.
• editor.wordWrap: 긴 코드 줄을 자동으로 줄바꿈 처리합니다.
• files.autoSave: 다른 창으로 포커스 이동 시 파일을 자동 저장합니다.
• editor.formatOnSave: 파일 저장 시 자동으로 코드 포맷팅을 적용합니다.
• editor.codeActionsOnSave: 저장할 때 가능한 오류를 자동 수정합니다.
• terminal.integrated.fontSize: 터미널 글자 크기를 13px로 설정합니다.
• workbench.startupEditor: VSCode 실행 시 빈 화면으로 시작합니다.
• breadcrumbs.enabled: 현재 파일 경로를 상단에 표시합니다.

추가 추천 설정

개발 스타일이나 사용하는 언어에 따라 다음 설정도 고려할 수 있습니다.

• "editor.minimap.enabled": false → 미니맵(우측 미리보기) 비활성화
• "window.zoomLevel": 1 → 전체 에디터 UI 크기 확대
• "editor.cursorSmoothCaretAnimation": true → 커서 이동 애니메이션 적용

실무 팁

• settings.json은 개인 PC뿐만 아니라 클라우드 동기화를 통해 여러 기기에서 공유할 수 있습니다.
• 설정이 꼬였을 경우, 기존 settings.json 파일을 백업한 후 초기화하면 문제를 쉽게 해결할 수 있습니다.
• 언어나 프로젝트별로 다른 세팅이 필요한 경우, .vscode/settings.json을 별도로 구성하는 것도 좋은 방법입니다.

VSCode를 처음 설치한 후 기본 설정만 잘 잡아줘도 개발 생산성은 크게 향상됩니다. 이번 세팅 예제를 기반으로 자신만의 개발 환경을 꾸며보시기 바랍니다.

#VSCode #settings.json #개발환경 #코딩생산성 #VSCode세팅