VS Code에서 Tab 키 눌렀을 때 스페이스 개수 조절하는 방법

안녕하세요 꾸꾸입니다!

 

 

Tab 키를 눌렀을 때 자동으로 삽입되는 스페이스 개수를 조절하는 것은 프로그래밍 스타일을 통일하는 데 중요합니다. 특히, 여러 명이 협업하는 프로젝트에서는 일관된 들여쓰기가 유지되어야 코드 가독성이 향상됩니다.

이 글에서는 VS Code(Visual Studio Code)에서 Tab 키를 눌렀을 때 삽입되는 스페이스 개수를 조절하는 방법을 자세히 설명합니다.

---

🛠️ Tab 크기 설정이 중요한 이유

Tab 크기(=스페이스 개수)는 단순한 개인 취향 문제가 아니라, 다음과 같은 이유로 중요합니다.

✅ 코드 가독성 향상: 일관된 들여쓰기로 인해 코드를 더 쉽게 읽을 수 있습니다.
✅ 팀 협업 필수 요소: 협업하는 개발자들이 서로 다른 환경에서 작업할 때도 코드 포맷을 통일할 수 있습니다.
✅ Lint 규칙 적용: Python의 PEP 8처럼 특정 스타일 가이드를 따르는 경우 필수적인 설정입니다.
✅ Git Diff 최소화: 서로 다른 Tab 크기를 사용하면 Git에서 불필요한 변경 사항이 발생할 수 있습니다.

---

⚙️ VS Code에서 Tab 크기 조절하는 방법

1️⃣ 설정(UI)에서 변경하는 방법

1. VS Code 실행
2. Command Palette 열기 (Ctrl + Shift + P)
3. "Preferences: Open Settings (UI)" 입력 후 클릭
4. 검색창에 "tab size" 입력
5. Editor: Tab Size 설정을 원하는 값(예: 2, 4)으로 변경

💡 Tip:

• 기본값은 4이며, 2로 설정하면 더 컴팩트한 코드 스타일을 유지할 수 있습니다.
• 8처럼 큰 값은 가독성을 해칠 수 있으므로 권장하지 않습니다.

---

2️⃣ 언어별 Tab 크기 설정하기

프로그래밍 언어별로 다른 Tab 크기를 사용하고 싶다면, 아래 방법을 활용하세요.

1. Command Palette(Ctrl + Shift + P) 열기
2. "Preferences: Open User Settings (JSON)" 입력 후 클릭
3. JSON 설정 파일에서 언어별 설정 추가

{
  "[cpp]": {
    "editor.tabSize": 4,
    "editor.insertSpaces": true
  },
  "[python]": {
    "editor.tabSize": 2,
    "editor.insertSpaces": true
  }
}

📌 설명

• C++ (.cpp) 파일에서는 4칸 스페이스
• Python (.py) 파일에서는 2칸 스페이스

이렇게 설정하면 언어별 스타일을 유지하면서 가독성을 최적화할 수 있습니다.

---

3️⃣ 파일별 설정 변경하기

특정 파일에서만 Tab 크기를 변경하고 싶다면 VS Code의 상태바에서 조절할 수 있습니다.

1. 파일을 열고 VS Code 하단 상태바 확인
2. "Spaces: 4" 혹은 "Tab Size: 4" 클릭
3. 원하는 값(예: 2, 4, 8)으로 변경

이 방법은 개별 파일에서만 설정이 적용되므로 프로젝트 전체에 영향을 주지 않습니다.

---

4️⃣ 자동으로 스페이스 변환 설정 (탭 → 스페이스 변환)

Tab 키를 눌렀을 때 실제 탭 문자(Tab)가 아닌 스페이스(Space)로 변환하고 싶다면 다음 설정을 추가하세요.

{
  "editor.insertSpaces": true
}

✅ true → Tab 키 입력 시 스페이스로 변환
❌ false → Tab 키 입력 시 실제 \t(탭 문자) 입력

대부분의 코드 스타일 가이드(Python, JavaScript, HTML 등)에서는 스페이스 사용을 권장하므로 true로 설정하는 것이 좋습니다.

---

5️⃣ 프로젝트별 Tab 크기 설정하기 (.editorconfig 사용)

협업 프로젝트에서 개발자들이 일관된 Tab 크기를 유지하도록 강제하고 싶다면 .editorconfig 파일을 활용할 수 있습니다.

1. 프로젝트 폴더에 .editorconfig 파일 생성
2. 아래 내용을 추가

[*]
indent_style = space
indent_size = 4

[*.py]
indent_size = 2

📌 설명

• 모든 파일(*)은 4칸 스페이스
• Python(*.py) 파일만 2칸 스페이스

이 설정은 VS Code뿐만 아니라 다른 IDE(예: JetBrains, Sublime Text)에서도 적용 가능하므로 협업 환경에서 유용합니다.

---

🏆 최종 정리: 추천 설정

환경	설정 방법	예시 값
기본 설정	Preferences > Editor: Tab Size	2 또는 4
언어별 설정	settings.json	[cpp]: 4, [python]: 2
특정 파일만 변경	상태바에서 직접 조절	Spaces: 2
자동 스페이스 변환	"editor.insertSpaces": true	true
프로젝트별 적용	.editorconfig 활용	[*.py] indent_size=2

 

💡 추천 값

• 웹 개발(JavaScript, HTML, CSS): 2칸
• Python, YAML: 2칸 (PEP 8 권장)
• C++, Java, C#: 4칸 (일반적인 스타일)

---

🎯 마무리: 내 코드 스타일에 맞는 설정 찾기

Tab 크기 설정은 코드 가독성과 협업 효율성을 높이기 위해 필수적인 요소입니다.

📌 가장 중요한 포인트
✅ Tab 크기 설정은 개인이 아닌 팀 규칙에 맞춰야 한다.
✅ 언어별, 프로젝트별로 적절한 크기를 설정하는 것이 중요하다.
✅ VS Code의 UI/JSON 설정, .editorconfig를 활용하면 손쉽게 관리 가능하다.