VSCode 프로젝트별 설정 분리로 코딩 능률 200% 올리는 법 (설정 우선순위 가이드)

개발을 하다 보면 참 난감한 순간이 옵니다. A 프로젝트에서는 탭 간격 2를 쓰는데, 새로 들어간 B 프로젝트는 탭 간격 4를 고집하죠. 매번 설정창 들어가서 고치기도 번거롭고, 깜빡하고 커밋했다가 코드 포맷이 엉망이라며 반려당하면 그것만큼 기운 빠지는 일도 없습니다. "그냥 알아서 바뀌면 안 되나?"라는 고민, 사실 모든 개발자가 한 번쯤은 해보셨을 겁니다.

왜 굳이 프로젝트마다 설정을 따로 해야 할까?

우리가 흔히 쓰는 VSCode 설정은 '사용자 설정(User Settings)'입니다. 이건 내 컴퓨터에 설치된 모든 VSCode 창에 공통으로 적용되는 전역 규칙이죠. 하지만 협업 환경에서는 이 전역 규칙이 오히려 독이 될 때가 많습니다. 팀원마다 들여쓰기나 저장 시 자동 정렬 옵션이 다르면 코드 리뷰 단계에서 로직이 아닌 '공백 차이'로 불필요한 에너지를 낭비하게 되거든요.

 

프로젝트별 설정을 분리하면 해당 프로젝트 폴더 안에 별도의 설정 파일이 생깁니다. 이걸 Git 같은 버전 관리 시스템에 포함하면, 팀원 누구든 프로젝트를 열자마자 동일한 개발 환경을 갖게 됩니다. 마치 집안일 규칙을 정해두면 누가 와도 청소 방식이 똑같아지는 것과 같은 원리입니다.

직접 경험하며 느낀 설정 분리의 명확한 차이

제가 예전에 PHP 기반의 레거시 시스템과 최신 Java Spring 프로젝트를 동시에 관리할 때의 일입니다. PHP 쪽은 오래된 관습 때문에 Tab 문자를 그대로 썼고, Java 쪽은 Space 2칸을 썼죠. 처음에는 수동으로 바꿨는데, 일주일 만에 실수가 터졌습니다. Java 코드에 탭이 섞여 들어간 거죠. 결국 작업 영역(Workspace) 설정을 도입했고, 결과는 놀라웠습니다.

비교 항목	사용자 전역 설정	프로젝트별 분리 설정
환경 전환 속도	매번 수동 변경 (느림)	자동 인식 (즉시)
협업 일관성	팀원별로 제각각	100% 일치 가능
관리 난이도	단순하지만 위험함	약간의 초기 세팅 필요

 

표를 보면 알 수 있듯, 프로젝트별 분리 방식이 초기 세팅 시간은 5분 정도 더 걸릴지 몰라도 장기적인 유지보수와 협업에서는 압도적인 효율을 보여줍니다. 특히 여러 언어를 다루는 풀스택 개발자라면 선택이 아닌 필수라고 봅니다.

VSCode 프로젝트 설정 분리 가이드 - 생성형 ai 이미지

📌 프로젝트 설정이 전역 설정보다 우선순위가 높나요?

네, 맞습니다! VSCode는 설정을 읽어올 때 일정한 계층 구조를 따릅니다. 가장 먼저 '기본 설정'을 읽고, 그다음 사용자가 정의한 '전역 설정'을 입힙니다. 그리고 마지막으로 현재 열려 있는 폴더 안의 '작업 영역(.vscode) 설정'을 적용합니다. 즉, 같은 옵션이 두 곳에 모두 있다면 프로젝트별 폴더 안의 설정이 최종적으로 승리하게 됩니다. 특정 프로젝트에서만 특별한 폰트를 쓰거나 테마를 바꾸고 싶을 때 아주 유용하죠.

분리해서 쓰는 구체적인 방법과 팁

방법은 의외로 간단합니다. 프로젝트 루트 디렉토리에 .vscode라는 이름의 폴더를 만들고, 그 안에 settings.json 파일을 생성하면 끝입니다. 하지만 직접 해보면 몇 가지 주의할 점이 있어요.

• 확장 프로그램 권장 사항 포함: extensions.json 파일을 함께 만들어서 팀원들이 꼭 설치해야 할 플러그인을 지정하세요. 프로젝트를 처음 연 팀원에게 "이 확장 프로그램을 설치하시겠습니까?"라는 팝업이 떠서 일일이 가이드할 필요가 없어집니다.
• 보안 주의: 설정 파일에 API 키나 개인적인 경로가 포함되지 않도록 주의해야 합니다. 공용 설정만 담고 개인적인 취향(테마 색상 등)은 가급적 전역 설정에 두는 것이 매너입니다.
• 디버깅 설정 분리: launch.json을 통해 프로젝트마다 다른 실행 환경(포트 번호, 환경 변수 등)을 세팅해두면 'F5' 키 하나로 즉시 테스트가 가능해집니다.

솔직히 말씀드리면, 처음에는 이 과정이 귀찮게 느껴질 수 있습니다. 하지만 한 달만 지나보세요. 프로젝트 바꿀 때마다 설정 꼬여서 git diff가 수백 줄씩 뜨는 지옥에서 벗어나는 순간, "왜 이제야 했지?"라는 생각이 절로 드실 겁니다. 이건 직접 겪어봐야 체감되는 영역입니다.

상황별 최적의 선택 가이드

모든 경우에 설정을 분리할 필요는 없습니다. 본인의 상황에 맞춰 선택해 보세요.

• 나 혼자 공부용으로 만드는 토이 프로젝트: 굳이 분리할 필요 없습니다. 전역 설정으로 편하게 작업하세요.
• 2인 이상의 팀 프로젝트: 무조건 분리하세요. 한 명이라도 Prettier 설정이 다르면 커밋 지옥이 펼쳐집니다.
• 오픈소스 기여: 해당 저장소의 .vscode 규칙을 따르거나, 없다면 개인 설정을 절대 커밋에 포함하지 않도록 .gitignore에 추가하는 배려가 필요합니다.

결국 도구는 사용하기 나름이지만, VSCode가 제공하는 이 강력한 기능을 썩히는 건 아까운 일이죠. 오늘 당장 진행 중인 메인 프로젝트 폴더에 .vscode 폴더 하나 만들어보는 건 어떨까요? 작은 습관 하나가 여러분의 퇴근 시간을 앞당겨줄지도 모릅니다. 궁금한 점이 있다면 언제든 편하게 의견 나눠주세요.

IntelliJ 테스트 실행 속도 느릴 때 10초 만에 해결하는 체크리스트